DPTCloud
Back to articles
Technology Insight

Self-Hosting Leantime on Docker: A Secure, Open-Source Project Management Solution for Internal Teams

June 5, 2026

Introduction: The Growing Need for Project Data Sovereignty

In the modern corporate landscape, data is arguably an organization’s most valuable asset. As businesses increasingly rely on project management platforms to orchestrate daily workflows, track milestones, and manage internal communication, the security of project metadata becomes paramount. Relying entirely on public SaaS (Software as a Service) providers introduces inherent risks, including third-party data breaches, compliance complications, and unpredictable subscription scaling costs.

For organizations prioritizing maximum data sovereignty, self-hosting provides an elegant and robust solution. By hosting your own project management infrastructure, your organization retains absolute ownership and control over every task description, timeline, and intellectual property asset. Among the available open-source tools, Leantime has emerged as a premier choice, combining standard project management features with lean product development methodology. When coupled with Docker, deploying and maintaining Leantime becomes a streamlined, scalable, and highly secure operation.

What is Leantime?

Leantime is an open-source project management system designed specifically for non-project managers, startups, and innovative corporate teams. Unlike overly complex enterprise tools or overly simplistic task boards, Leantime strikes a balance by integrating:

  • Task Management: Kanban boards, table views, and detailed task tracking.
  • Strategic Planning: Goal tracking, research boards, and idea management tools.
  • Time Management: Integrated timesheets and built-in time tracking mechanics.
  • Progress Reporting: Visual milestones, Gantt charts, and clear project dashboards.

By shifting this comprehensive feature set to an on-premise or private cloud infrastructure via Docker, enterprise teams can collaborate efficiently without exposing intellectual property to external entities.

Why Deploy Leantime via Docker?

Deploying application stacks manually can lead to configuration drift, dependency conflicts, and maintenance headaches. Utilizing Docker containerization transforms this process by offering several distinct enterprise advantages:

  1. Environment Isolation: Docker encapsulates the Leantime application, its dependencies, and the underlying database into isolated containers, eliminating conflicts with host system software.
  2. Portability and Consistency: A Dockerized Leantime instance behaves identically whether run on a local development server, a private on-premise data center, or a Virtual Private Cloud (VPC) like AWS or DigitalOcean.
  3. Rapid Deployment and Updates: Upgrading to newer versions of Leantime becomes as simple as pulling an updated Docker image and restarting the container container stack, minimizing operational downtime.

Prerequisites for Deployment

Before initiating the installation, ensure your target server meets the following fundamental requirements:

A baseline virtual private server (VPS) or on-premise machine running a stable Linux distribution (e.g., Ubuntu Server 22.04 LTS or newer), equipped with at least 2 vCPUs, 4GB of RAM, and sufficient SSD storage based on your team’s file-sharing needs.

Additionally, you must have administrative (root) access and ensure that both Docker Engine and Docker Compose (v2 or higher) are installed and fully operational on the host system.

Step-by-Step Technical Guide: Deploying Leantime via Docker Compose

To establish a production-ready, secure environment, we will utilize a multi-container architecture utilizing Docker Compose. This architecture isolates the Leantime application layer from the persistent relational database layer.

Step 1: Establishing the Directory Structure

First, create a dedicated directory on your server to house the configuration files and persistent data volumes:

mkdir -p /opt/leantime && cd /opt/leantime

Step 2: Designing the docker-compose.yml File

Create a configuration file named docker-compose.yml within your directory. This file defines the Leantime application service and its supporting MariaDB database container:

version: '3.8'

services:
  leantime_db:
    image: mariadb:10.6
    container_name: leantime_database
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: YourSuperSecureRootPassword
      MYSQL_DATABASE: leantime_db
      MYSQL_USER: leantime_user
      MYSQL_PASSWORD: YourSuperSecureUserPassword
    volumes:
      - db_data:/var/lib/mysql
    networks:
      - leantime_network

  leantime_app:
    image: leantime/leantime:latest
    container_name: leantime_application
    restart: always
    ports:
      - "8080:80"
    environment:
      - LEAN_DB_HOST=leantime_db
      - LEAN_DB_USER=leantime_user
      - LEAN_DB_PASSWORD=YourSuperSecureUserPassword
      - LEAN_DB_DATABASE=leantime_db
      - LEAN_APP_URL=[https://projects.yourcompany.com](https://projects.yourcompany.com)
    volumes:
      - app_userfiles:/var/www/html/userfiles
    depends_on:
      - leantime_db
    networks:
      - leantime_network

volumes:
  db_data:
  app_userfiles:

networks:
  leantime_network:
    driver: bridge

Note: It is crucial to replace placeholder credentials like 'YourSuperSecureUserPassword' with cryptographically secure, randomized strings before deploying to a live network environment.

Step 3: Launching the Stack

With the composition file finalized, execute the command to pull the official images and run the containers in the background:

docker compose up -d

Verify that both containers are running without errors by executing docker compose ps.

Crucial Security Enhancements for Corporate Networks

Deploying the default containers is only the first step. To guarantee absolute data security within your enterprise, several hardening measures must be strictly enforced:

1. Implementation of an SSL/TLS Reverse Proxy

Never expose the raw HTTP port (8080) directly to the open internet. Intercept incoming traffic using a production-grade reverse proxy such as Nginx, Traefik, or Caddy. Configure the proxy to enforce HTTPS utilizing valid TLS certificates from Let’s Encrypt. This prevents credential eavesdropping and man-in-the-middle attacks.

2. Restricting Network Access (Firewall and VPN)

If Leantime is intended strictly for internal corporate use, use system firewalls (like UFW or iptables) to block all public external access to the container ports. Force users to connect via a secure corporate VPN (e.g., WireGuard or OpenVPN) or utilize Zero Trust network access layers like Cloudflare Tunnels or Tailscale before they can reach the login interface.

3. Automated Database Backup Protocols

Data security implies data resilience. Set up automated daily cron jobs on the host machine to execute database dumps from the MariaDB container and back up the persistent volume directories. Ensure these backups are encrypted and stored in a secondary, isolated off-site location.

Conclusion: Long-term Maintenance and Value

Self-hosting Leantime on Docker empowers your business with complete sovereignty over internal data, removing dependence on external vendors while eliminating recurring subscription fees. Over time, maintaining this environment requires minimal effort—primarily consisting of keeping the Docker containers updated and monitoring server performance logs.

By establishing this secure infrastructure, your organization gains a highly modern, efficient, and fully private workspace tailored for strategic growth, operational excellence, and unmatched digital privacy.