Skip to content

One-command trial

Anyone who wants to try calServer 2 receives an email with a trial code and a command. The command sets up calServer on an empty Linux server and comes with a 30-day licence, all modules included.

curl -fsSL https://get.calserver.com | sudo sh -s -- --trial tr_…

Requirements

Minimum Recommended
System Ubuntu 22.04/24.04, Debian 12/13, RHEL 9 (Rocky, Alma), x86_64 Ubuntu 24.04
Memory 4 GB 8 GB
Free disk 20 GB 60 GB
Network Ports 80 and 443 free, outbound HTTPS

Docker 24 or later and Compose 2.20 or later. If Docker is missing, the installer offers to install it with Docker's official script.

The server must be empty: if calServer is already running, or another web server holds port 80 or 443, the installer stops before changing anything.

With your own name

If a DNS name points at the server, you get a Let's Encrypt certificate:

curl -fsSL https://get.calserver.com | sudo sh -s -- --trial tr_… --domain calserver.my-lab.com --email it@my-lab.com

Without --domain, calServer runs on the server's IP address with a self-signed certificate. The browser warns once on the first visit.

What the installer does

  1. Check the requirements.
  2. Download the installation bundle and verify signature and checksum.
  3. Create /opt/calserver/.env (random passwords and keys).
  4. Redeem the trial code with the licence service.
  5. Pull the images from registry.calhelp.de and start calServer.
  6. Set up the database, store the licence and print a setup code.

If a run is interrupted, the same command picks up where it stopped. The trial code is not lost.

Take over the installation

At the end you get the address and a six-digit setup code. Open the address, enter the code, and fill in lab, name, email and password. This creates the first account with the roles Administration, Laborleitung and Techniker. The installer never prints a password.

The code is valid for 24 hours and five attempts. As long as nobody has taken the installation over, a new one is available with:

docker exec calserver-api-v2 php artisan install:setup-code

After 30 days

Your data stays readable and exportable; changes need a purchased licence. No reinstall needed: enter the licence key under Administration → Subscription & Modules.

Troubleshooting

sudo sh /opt/calserver/installer/install.sh --diagnose

prints system, Docker, containers, installer progress and the last API log lines, without passwords or keys.