TiloBox
Back to directory
Leantime project preview

Leantime

A self-hosted project management system connecting goals, plans, tasks, time records, and team collaboration.

LicenseAGPL-3.0
GitHub stars11.4k
Last commit2 weeks ago
Tags6 topics
ProductivitySelf HostedProject ManagementOpen SourcePhpDocker
Overview

Why consider Leantime?

Leantime is an open-source, self-hostable project management system built with ADHD, autism, and dyslexia in mind. It combines strategy, planning, and execution in one tool—offering kanban boards, Gantt timelines, goal tracking, sprints, timesheets, wikis, and AI-powered task breakdown—while keeping the interface simple enough for non-project managers.

Guided learning

Learn Leantime by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

4 min read 9 sections
In this guide9 sections

Getting Started with Leantime: Neurodivergent-First Project Management

Leantime is an open-source project management system for non-project managers, built with ADHD, autism, and dyslexia in mind. It combines strategy, planning, and execution while making it easy for everyone on the team to use. Unlike rigid enterprise tools, Leantime is designed around how neurodivergent brains actually work—favouring interest-driven goals, clear visual cues, and reduced cognitive overhead over abstract deadlines and overwhelming feature sets.

Key Features at a Glance

All features listed below are included in the open-source version (AGPL-3.0):

CategoryWhat you get
Task ManagementKanban, Gantt/timeline, table, list, and calendar views; unlimited subtasks and dependencies; milestones; sprints
Project PlanningDashboards, reports, goal & metrics tracking, Lean Canvas, SWOT, risk analysis
Knowledge ManagementWikis/docs, idea boards, retrospectives, file storage (S3 or local), comments on everything
AdministrationTwo-factor auth, LDAP/OIDC integration, multiple user roles, Slack/Mattermost/Discord integrations, 20+ languages, plugin API
Neurodivergent UXAI-powered task breakdown, emoji sentiment tagging, dopamine-boosting progress visuals, time-blocking, distraction-free mode

System Requirements

Before installing, confirm your server meets these minimums (from the official README):

  • PHP 8.2+
  • MySQL 8.0+ or MariaDB 10.6+
  • Apache or Nginx (IIS works with modifications)
  • Required PHP extensions: bcmath, ctype, curl, dom, exif, fileinfo, gd, mbstring, mysqli, openssl, pcntl, pdo, zip, and others

The fastest path to a working Leantime instance is Docker Compose via the official docker-leantime repository.

Step 1 — Clone the Docker repository

bash
1git clone https://github.com/Leantime/docker-leantime.git
2cd docker-leantime

Step 2 — Configure your environment

Copy the sample environment file and open it in your editor:

bash
1cp sample.env .env

At minimum, set these variables inside .env:

env
1LEAN_APP_URL=http://localhost:8080
2MYSQL_ROOT_PASSWORD=yourSecureRootPassword
3MYSQL_DATABASE=leantime
4MYSQL_USER=leantime
5MYSQL_PASSWORD=yourSecurePassword

Step 3 — Start the stack

The official docker-compose.yml (source: https://raw.githubusercontent.com/Leantime/docker-leantime/master/docker-compose.yml) defines two services—a MySQL 8.4 database and the Leantime application container:

yaml
1version: '3.3'
2
3services:
4 leantime_db:
5 image: mysql:8.4
6 container_name: mysql_leantime
7 volumes:
8 - db_data:/var/lib/mysql
9 restart: unless-stopped
10 env_file: ./.env
11 networks:
12 - leantime-net
13 command: --character-set-server=UTF8MB4 --collation-server=UTF8MB4_unicode_ci
14 healthcheck:
15 test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
16 interval: 30s
17 timeout: 10s
18 retries: 3
19
20 leantime:
21 image: leantime/leantime:${LEAN_VERSION:-latest}
22 restart: unless-stopped
23 env_file: ./.env
24 security_opt:
25 - no-new-pr

Bring both containers up in detached mode:

bash
1docker-compose up -d

Then visit http://localhost:8080 (or your configured domain) to complete the setup wizard.

Once inside, Leantime separates concerns in a way that reduces executive-function load:

  • My Work dashboard — A personal hub showing tasks grouped by Overdue, Due this week, and Due later, plus a day-view calendar and high-level metrics. This combats time-blindness by surfacing only what matters right now.
  • Goals module — Tracks strategic objectives with measurable metrics so every task visibly connects to a larger purpose, feeding the interest-driven motivation loop common in ADHD brains.
  • Multiple task views — Switch between kanban, table, list, Gantt, or calendar depending on how you best process information. Each view is a first-class citizen, not an afterthought.
  • Emoji sentiment tags — Add emotional context directly to tasks to stay connected to why something matters or to surface blockers before they become blockers.
  • AI task breakdown — When a project feels overwhelming, the built-in AI assistant can decompose it into smaller, actionable steps automatically.

Upgrading and Maintenance

To upgrade a running Docker installation, pull the latest image and recreate the containers. Always back up your database first:

bash
1# Backup the database
2docker exec mysql_leantime mysqldump -u root -p leantime > leantime_backup.sql
3
4# Pull latest image and restart
5docker-compose pull
6docker-compose up -d

For troubleshooting, inspect container logs:

bash
1docker logs leantime
2docker ps -a

Community and Extending Leantime

Leantime is extensible via a plugin and REST API system and integrates out-of-the-box with Slack, Mattermost, and Discord. The project is actively translated through Crowdin and is available in over 20 languages. You can join the community on Discord, contribute translations at Crowdin, or browse the source on GitHub.

The Docker image is published to Docker Hub at leantime/leantime and has accumulated a significant number of pulls, reflecting wide adoption among self-hosters looking for a Jira/Asana alternative that respects neurodivergent workflows.

Related tools

More options with a similar category or technology profile.

Leantime FAQs

Leantime is listed as a Productivity tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository and official website for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

Leantime is listed under the AGPL-3.0 license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

Leantime is listed as an alternative to Asana. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.