Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Newly installed wiki not sending mail confirmations #181

Open
ajhurst opened this issue Jan 14, 2025 · 20 comments
Open

Newly installed wiki not sending mail confirmations #181

ajhurst opened this issue Jan 14, 2025 · 20 comments
Labels
question Further information is requested

Comments

@ajhurst
Copy link

ajhurst commented Jan 14, 2025

I have just installed Otter Wiki, and I have had trouble confirming my email address. Although the wiki says that a confirmation email has been sent, it never arrives.

The message that gets recorded by the log is:
"ERROR in helper: send_async_email(): Exception please run connect() first"

Can you please help?

@redimp redimp added the question Further information is requested label Jan 14, 2025
@redimp
Copy link
Owner

redimp commented Jan 14, 2025

Hey @ajhurst,

please double check the configuration in Setting > Mail Preferences.

You find a block "Test Mail Preferences" below the settings with a Send Test Mail button. Please try this and share what you find in the log, e.g.

[2025-01-14 11:39:58,684] ERROR in helper: send_async_email(): ...

@ajhurst
Copy link
Author

ajhurst commented Jan 14, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 14, 2025

The first user that is registered doesn't need to confirm the email adress and is an admin-account by default.

@ajhurst
Copy link
Author

ajhurst commented Jan 14, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 14, 2025

The first user you registered, needs no confirmation mail. You should b able to log in with the email and the password you provided.

As soon as you are logged in, you find the settings in the dots Menu in navbar:
image

@ajhurst
Copy link
Author

ajhurst commented Jan 14, 2025 via email

@ajhurst
Copy link
Author

ajhurst commented Jan 15, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 15, 2025

Sure, using which method did you install it?

@ajhurst
Copy link
Author

ajhurst commented Jan 15, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 15, 2025

With the docker cli there is not much to uninstall. Under the assumption that you ran

docker run --name otterwiki \
    -p 8080:80 \
    -v $PWD/app-data:/app-data \
    redimp/otterwiki:2

all files created by the wiki can be found in the local app-data directory. Just rename it if you have created something, or remove it if not.

If you have not iused a local directory as volume, please check the docker docs on how to remove the volume.

For your next try let me suggest to use docker compose the recommended method for running An Otter Wiki. ✌️

@ajhurst
Copy link
Author

ajhurst commented Jan 19, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 19, 2025

Hey @ajhurst, digging into the details of your environment is a bit out of scope. Please understand that I can only provide limited support. Lets start with a few questions:

  1. What is your OS?
  2. In case of linux: Which distribution?
  3. How did you install and run docker in first place?

@ajhurst
Copy link
Author

ajhurst commented Jan 20, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 20, 2025

Hey John, good to hear that you got An Otter Wiki running!

You are on the right track, according to this fastmail.help article you have to set Mail Security to SSL to enable an ecrypted connection to the fastmail servers.

@ajhurst
Copy link
Author

ajhurst commented Jan 24, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 24, 2025

Hey John, of course!

Logg in as admin (the first registered user is an Admin) open up the dots Menu > Settings, on the left open Permissions and Registration and you find an Option [ ] Disable Registration there.

... But I don't think that is waht you want, I guess you want to disable that the confirmation mail is necessary?

Disable [ ] Registration requires email confirmation and hit Save Preferences.

@ajhurst
Copy link
Author

ajhurst commented Jan 24, 2025 via email

@ajhurst
Copy link
Author

ajhurst commented Jan 29, 2025 via email

@redimp
Copy link
Owner

redimp commented Jan 30, 2025

Hey John, happy to help. First: The documentation needs to be improved, the default behaviour is confusing if one expects the Wiki pages behave like files, because they are stored in ... files.

(1) Page: One Body, Many Members

This should work fine:

Create Page

Image

Editor opens up

Image

Please note, this is working perfectly fine, that there are %20 in the url is just the way how spaces are encoded in Urls.

Saving the page leads to:

Image

And in the Page Index:

Image

@redimp
Copy link
Owner

redimp commented Jan 30, 2025

(2) Upper and lower case in pagenames

Per default An Otter Wiki stores all pages in all lower case names, so no matter which Pagename you pick

  • home
  • Home
  • hOme
  • HomE

it will always be stored in home.md.

Links to the page are resolved ignoring case, too. e.g.:

To make it possible that a page can have upper and lower case in the name, An Otter wiki relies on the pages header, if the first header, e.g.

# Home

matches the page name, the headers case is used to display the page name for example in the Page Index.

Note: This is different when you have set RETAIN_PAGE_NAME_CASE .. then only the correct spelled case will resolve the page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
question Further information is requested
Projects
None yet
Development

No branches or pull requests

2 participants