Deploy Kimai

Kimai time tracking with private MariaDB and a generated admin login

Deploy Kimai

Kimai

Just deployed

/opt/kimai/var

Data

Just deployed

/var/lib/mysql

Deploy and Host Kimai on Railway

Kimai is an open-source time tracker for freelancers and teams. You record work hours against customers, projects and activities, with a punch clock or by entering timesheets, then report on them, export them and turn them into invoices. It has user roles, teams, budgets, a JSON API and apps that connect to it.

Kimai is a registered trademark of Kevin Papst. This Railway template is an independent project and is not affiliated with Kimai or Kevin Papst. It runs the unmodified official Kimai image.

About Hosting Kimai

The template runs Kimai 2.72.1 (Apache image) and MariaDB 11.8 LTS, both from official images pinned by digest. Kimai is the only public service; MariaDB is reachable only over Railway's private network, Kimai connects with a user limited to its own database, and the root account cannot log in over the network. Timesheets, users, settings and login sessions live in MariaDB on its volume; Kimai's own volume keeps its generated APP_SECRET, invoice files and plugins, so logins and remember-me cookies survive restarts. On the first boot Kimai runs its migrations and creates an admin account from ADMINMAIL (set it to your address before deploying) and a generated password, which you copy from the Kimai service's variables. Self-registration stays off, so nobody else can claim the instance.

Why Deploy Kimai on Railway

Railway provides the HTTPS domain, private networking between Kimai and MariaDB, persistent volumes, generated secrets and health-checked deploys. Kimai waits for MariaDB before it starts, so first deploys and restarts come up in order. The template also fixes how Kimai sees visitors behind Railway's proxy: login throttling applies to each visitor's own address, so a few wrong passwords from one person cannot lock everyone else out.

Common Use Cases

  • Track billable hours for clients and projects as a freelancer or agency
  • Record team working time with roles, teams, budgets and approval by team leads
  • Export timesheets and create invoices from tracked time, on your own server

Dependencies for Kimai Hosting

The deployment uses Kimai and MariaDB Server.

Deployment Dependencies

  • Kimai 2.72.1 (kimai.org, documentation) with a 5 GB volume for its secret, invoices and plugins
  • MariaDB 11.8 LTS with a 5 GB volume
  • Optional: an SMTP provider on port 465 or 587 (MAILER_URL, MAILER_FROM) for invitations; password resets also need TRUSTED_HOSTS, an anchored pattern of your Kimai host plus healthcheck.railway.app

Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0