Self-hosting Tadbir

Most customers use Tadbir Cloud. If your contract is on your own servers, this section is for the person who installs and runs Tadbir: your system administrator. It assumes comfort with a Linux shell and Docker, not any knowledge of Tadbir's internals.

What you install

• One server, one installation. Tadbir runs as a single application (tadbir-standalone) with its web interface, database, sign-in service and offline maps, all on the same machine. Running Tadbir as separate services on several machines is not supported for self-hosting.
• Works without internet. Everything Tadbir needs is in the delivery: application images, fonts, icons and the map data for your countries. The server never downloads anything at install, start or upgrade time.
• Same modules and offers as Tadbir Cloud. What you can use is set by your license file, issued by Oloom for your offer (Essentials, Business, with or without Field Service), number of named users and term.

Five steps

1. Get the delivery from Oloom: the release bundle tadbir-onprem-<version>.tar and the map pack for your countries. See What Oloom delivers.
2. Prepare the server: Linux, Docker, a hostname and a certificate. See Requirements.
3. Configure: two values to fill in, everything else is generated. See Configuration.
4. Install with install.sh, then sign in as the first administrator. See Install.
5. Upload your license in Settings > License. See Your license.

Then: Day-to-day operations, Upgrades and Troubleshooting.

Getting access

Self-hosted deliveries are not downloaded from a public store. Your Oloom contact sends you the release bundle, its SHA-256 checksum (to compare with the bundle you received), the map pack for your countries, and later your license file. If you don't have these yet, reach out before starting.