---
title: "Deploy Kimai"
description: "Kimai time tracking with private MariaDB and a generated admin login"
category: "Other"
url: https://railway.com/deploy/kimai-2
---

# Deploy Kimai

Kimai time tracking with private MariaDB and a generated admin login

**[Deploy Kimai on Railway](https://railway.com/template/kimai-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/kimai-2/manifest.json

- **Creator:** Anton Orel's Projects
- **Category:** Other
- **Total deploys:** 1

## Template content

### Kimai

- **Image:** kimai/kimai2:2.72.1@sha256:ef2699052e6a6ff20a1b42279927b4512e462659f3bf7d23f80882a8218021b4
- **Start command:** `/bin/sh -ec "printf %s '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' | base64 -d | gunzip >/tmp/kimai-start.sh; exec /bin/bash /tmp/kimai-start.sh"`
- **Health check:** /en/login
- **Public domain:** Yes

### MariaDB

- **Image:** mariadb:11.8.9@sha256:e1d5495f445654134f226f55a41ce0da227116f6f27f283101f405c794d841fc
- **Start command:** `docker-entrypoint.sh mariadbd --datadir=/var/lib/mysql/data`

## Documentation

# 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](https://github.com/kimai/kimai) and [MariaDB](https://mariadb.org) Server.

### Deployment Dependencies

- Kimai 2.72.1 ([kimai.org](https://www.kimai.org), [documentation](https://www.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


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/kimai-2
