---
title: "Deploy Leantime"
description: "Goals-focused open-source project management, MySQL 8.4 and volumes"
category: "Other"
url: https://railway.com/deploy/leantime-1
---

# Deploy Leantime

Goals-focused open-source project management, MySQL 8.4 and volumes

**[Deploy Leantime on Railway](https://railway.com/template/leantime-1)**

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

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### MySQL https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mysql.png

- **Image:** mysql:8.4.13@sha256:a81d043930e51745522bd5c430961cf8286f0a23f0a9a2a6e0108f7ea71b0902
- **Start command:** `docker-entrypoint.sh mysqld --datadir=/var/lib/mysql/data --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci`

### Leantime https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/leantime.png

- **Source:** https://github.com/aalfath/leantime-railway-template
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host Leantime on Railway

Leantime is an open-source project management system for people who aren't project managers. It is built with ADHD, autism and dyslexia in mind and keeps work tied to goals: projects, to-dos on Kanban, table and list views, milestones and timelines, goals, idea boards, wikis, timesheets and retrospectives, in one PHP web app.

## About Hosting Leantime

Leantime needs a PHP web server, a MySQL database, a background scheduler for reminders and emails, and somewhere to keep uploaded files. This template runs Leantime 3.15.3 from the official image (pinned by digest), built from a public GitHub repo, with MySQL 8.4 LTS on the private network. On the first start it creates the tables and your administrator with a generated password, so the public web installer is never left open. Uploaded files, plugins and sessions stay on a volume and the database on its own volume, so redeploys keep everything. You only enter the admin email.

## Common Use Cases

* Project and task planning for small teams on Kanban, list, table or timeline views
* Linking day-to-day work to goals and milestones, with idea boards and retrospectives
* Time tracking, timesheets and team wikis kept on your own infrastructure

## Dependencies for Leantime Hosting

* MySQL 8.4 LTS (bundled, private network only)
* An SMTP account if you want Leantime to send email invites and notifications (optional, added after deploy)

### Deployment Dependencies

* Leantime: https://leantime.io and https://github.com/Leantime/leantime (release v3.15.3)
* Docker image: https://hub.docker.com/r/leantime/leantime (tag 3.15.3)
* Template repo: https://github.com/aalfath/leantime-railway-template
* MySQL: https://hub.docker.com/_/mysql (tag 8.4.13)

### Implementation Details

After deploy:

1. Open the Leantime service's domain and sign in with the `ADMIN_EMAIL` you entered and the generated `ADMIN_PASSWORD` (Leantime service, Variables tab). Change the password in your profile.
2. Set your company name, logo and colours under Company Settings, and your time zone in your profile.
3. For email invites and notifications, add `LEAN_EMAIL_USE_SMTP=true`, `LEAN_EMAIL_SMTP_HOSTS`, `LEAN_EMAIL_SMTP_PORT`, `LEAN_EMAIL_SMTP_USERNAME`, `LEAN_EMAIL_SMTP_PASSWORD` and `LEAN_EMAIL_RETURN` to the Leantime service. Without SMTP you can still create users and set their passwords yourself.

For a custom domain, add it to the Leantime service and set `LEAN_APP_URL` to `https://YOUR-DOMAIN`. Any other setting from Leantime's `sample.env` (S3 storage, OpenID Connect, LDAP) can be added as a variable. Keep `LEAN_SESSION_PASSWORD` unchanged after the first start.

Updates: version bumps are merged into the template repo, and Railway offers them to you as an "update available" notice. A newer version runs Leantime's database migrations by itself on start. Read the repo's CHANGELOG.md first and back up both volumes.

## Why Deploy Leantime on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Leantime on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## 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/leantime-1
