Appearance
Requirements
Check these before installing. The installer checks Docker, the tools, memory, free disk and root access, and stops with a clear message if one is missing.
Server
| Item | Requirement |
|---|---|
| Operating system | 64-bit Linux on x86-64 (Intel/AMD), for example Ubuntu 22.04/24.04 LTS or Debian 12 |
| Docker | Docker Engine 24 or newer, with the Compose v2 plugin (docker compose version works) |
| Tools | openssl, sha256sum, curl, tar, gzip (present on standard installs) |
| Memory | 8 GB minimum. 16 GB recommended: the containers are limited to about 10 GB together (database 1 GB, sign-in 2 GB, application 3 GB, address search 3 GB, map tiles 1 GB) |
| Disk | 20 GB free under the data directory (default /srv/tadbir) at install time, plus the size of your map pack, your data and backups. Upgrades temporarily need a copy of the database |
| Access | root (or sudo) to run the scripts |
| Service manager | systemd for the automatic daily backup. Without it, schedule the backup yourself |
Network
- No internet access is needed. Users only reach the server on your network.
- Ports 80 and 443 must be free on the server. Port 80 only redirects to 443. No other port is opened.
- A hostname, for example
tadbir.acme.lan, that users' computers resolve to the server: an entry in your internal DNS, or in each device's hosts file. No public DNS is needed.
Certificate
Tadbir is served over HTTPS only. Either:
- Your own certificate for the hostname, from your company's certificate authority:
cert.pem(full chain) andkey.pem, or - A self-signed certificate that the installer generates. Browsers show a warning until you install that certificate as trusted on each device. Phones and some browser features require a trusted certificate.
Email (optional)
Without email, the first administrator, sign-in and license upload all work. Staff invitations, resending an invitation and password-reset emails need an SMTP server that the Tadbir server can reach. See Configuration.
Time
Keep the server clock correct, ideally with your network's time server. If the clock moves back by more than 24 hours, Tadbir treats the license as invalid until the clock is fixed. See Your license.
Browsers
Current versions of Chrome, Edge, Firefox and Safari.