Troubleshooting

This page lists some problems and their solutions that may occur when using your Zettelstore.

Authentication

• Problem: Authentication is enabled for a local running Zettelstore and there is a valid user zettel for the owner. But entering user name and password at the web user interface seems to be ignored, while entering a wrong password will result in an error message.

  • Explanation: A local running Zettelstore typically means, that you are accessing the Zettelstore using an URL with schema http://, and not https://, for example http://localhost:23123. The difference between these two is the missing encryption of user name / password and for the answer of the Zettelstore if you use the http:// schema. To be secure by default, the Zettelstore will not work in an insecure environment.
  • Solution 1: If you are sure that your communication medium is safe, even if you use the http:// schema (for example, you are running the Zettelstore on the same computer you are working on, or if the Zettelstore is running on a computer in your protected local network), then you could add the entry insecure-cookie: true in you startup configuration file.
  • Solution 2: If you are not sure about the security of your communication medium (for example, if unknown persons might use your local network), then you should run an external server in front of your Zettelstore to enable the use of the https:// schema.