Docs / Self-Hosted Applications / How to Self-Host Leantime Project Management

How to Self-Host Leantime Project Management

By Admin · Mar 1, 2026 · Updated Apr 24, 2026 · 28 views · 2 min read

What Is Leantime?

Leantime is an open-source project management system designed for non-project-managers. It combines task boards, Gantt charts, time tracking, goal setting, and ideation tools in a simple interface. Leantime focuses on strategic alignment by connecting daily tasks to broader company objectives.

Prerequisites

  • A Breeze with at least 2 GB RAM running Ubuntu 22.04+
  • Docker and Docker Compose installed
  • A domain name pointed to your Breeze

Docker Compose Setup

mkdir -p ~/leantime && cd ~/leantime
version: "3.8"
services:
  leantime:
    image: leantime/leantime:latest
    container_name: leantime
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - LEAN_DB_HOST=leantime-db
      - LEAN_DB_USER=leantime
      - LEAN_DB_PASSWORD=DbPass789
      - LEAN_DB_DATABASE=leantime
      - LEAN_SITENAME=My Projects
      - LEAN_APP_URL=https://projects.yourdomain.com
    depends_on:
      - leantime-db

  leantime-db:
    image: mariadb:10.11
    container_name: leantime-db
    restart: unless-stopped
    volumes:
      - leantime_db:/var/lib/mysql
    environment:
      - MARIADB_ROOT_PASSWORD=RootPass456
      - MARIADB_DATABASE=leantime
      - MARIADB_USER=leantime
      - MARIADB_PASSWORD=DbPass789

volumes:
  leantime_db:

Launch and Set Up

docker compose up -d

Open http://your-breeze-ip:8080 and complete the initial setup wizard. Create your first project, set milestones, and start adding tasks to the Kanban board or Gantt timeline.

Key Features

  • Kanban boards, Gantt charts, and calendar views
  • Built-in time tracking for each task
  • Goal and milestone tracking tied to individual tasks
  • LDAP and OIDC authentication support for SSO

Was this article helpful?