Deploy Leantime
Goals-focused open-source project management, MySQL 8.4 and volumes
MySQL
Just deployed
/var/lib/mysql
Just deployed
/data
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:
- Open the Leantime service's domain and sign in with the
ADMIN_EMAILyou entered and the generatedADMIN_PASSWORD(Leantime service, Variables tab). Change the password in your profile. - Set your company name, logo and colours under Company Settings, and your time zone in your profile.
- 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_PASSWORDandLEAN_EMAIL_RETURNto 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.
Template Content
MySQL
mysql:8.4.13ADMIN_EMAIL
Email (login) of the first Leantime administrator, created on the first start.
