Installation guide

Before you start

The two ways to install the suite, and the file that names its administrators.

Choosing the way

The build runs on the development machine, with the repository and its tools, and hands over only what the target needs to run — never the source code. It comes in two forms, with the same services and the same apps.

  1. The image for Docker suits a Linux server with Docker Engine and a domain of its own: Caddy, inside the container, obtains the certificate from Let's Encrypt, so the domain must point at the machine and ports 80 and 443 must be reachable.
  2. The folder suits a Windows 11 x64 machine without Docker: it holds the services as programs, Caddy and the web pages, and serves HTTPS on port 8080 with a certificate of its own.
  3. Both start with an empty set of data and become usable with the first administrator: see The first administrator.
  4. Whichever you choose, keep the repository on the development machine: the upgrades are built there.

Tip The image is the way for a server open to the Internet; the folder suits a trial or a machine on the local network.

The administrators file

The installation's console opens only to the accounts listed in a plain text file called ADMINISTRATORS. Owning an organization is not enough: the file is the only list.

  1. Write one sign-in email per line; a line that starts with # is a comment, and upper or lower case makes no difference.
  2. With the image, the file is ADMINISTRATORS at the root of the repository on the server, mounted read-only into the container.
  3. With the folder, it is ADMINISTRATORS beside SERVER_CONFIGURATION.json; the variable MERYDION_ADMINISTRATORS_FILE can point to another path.
  4. The file is read again at every check: adding or removing a line takes effect at once, without restarting anything.

Tip A missing or empty file means no administrator at all: the console then refuses everyone.

Back to the guide

Productivity, made in Italy.

Bring the whole suite to your team — simple, secure and entirely yours.