
Deploy Kimai
Kimai time tracking with private MariaDB and a generated admin login
Kimai
Kimai
Just deployed
/opt/kimai/var
Data
MariaDB
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
Kimai
kimai/kimai2:2.72.1MariaDB
mariadb:11.8.9