Zettelstore installation for the intermediate user

You have already tried the Zettelstore software and now you want to use it permanently. Zettelstore should start automatically when you log into your computer.

• Grab the appropriate executable and copy it into the appropriate directory

• If you want to place your zettel into another directory, or if you want more than one Zettelstore box, or if you want to enable authentication, or if you want to tweak your Zettelstore in some other way, create an appropriate startup configuration file.

• If you created a startup configuration file, you need to test it:

  • Start a command line prompt for your operating system.

  • Navigate to the directory, where you placed the Zettelstore executable. In most cases, this is done by the command cd DIR, where DIR denotes the directory, where you placed the executable.

  • Start the Zettelstore:

    • On Windows execute the command zettelstore.exe run -c CONFIG_FILE
    • On macOS execute the command ./zettelstore run -c CONFIG_FILE
    • On Linux execute the command ./zettelstore run -c CONFIG_FILE

  • In all cases CONFIG_FILE must be replaced with the file name where you wrote the startup configuration.

  • If you encounter some error messages, update the startup configuration, and try again.

• Depending on your operating system, there are different ways to register Zettelstore to start automatically:

  • Windows
  • macOS
  • Linux

A word of caution: Never expose Zettelstore directly to the Internet. As a personal service, Zettelstore is not designed to handle all aspects of the open web. For instance, it lacks support for certificate handling, which is necessary for encrypted HTTP connections. To ensure security, install Zettelstore on a server and place it behind a proxy server designed for Internet exposure. For more details, see: External server to encrypt message transport.