Try describing what you need:

TimeTracker logo

TimeTracker

★ 645
GNU General Public License v3.0Open Core — Some Features Paid7 Containers — 7 containers — heavy hosting footprintDocker · Compose · BinaryNeeds PostgresTelemetry: Opt-Out13+ active committers (12mo)

About

TimeTracker is a self-hosted web application for professional time tracking and project management. It is aimed at freelancers, small teams, agencies, and privacy-focused organizations that want to...

Community Ratings

No ratings yet

Features

  • time tracking
  • project management
  • invoice generation
  • reports
  • dashboard
  • timer controls
  • time entries export
  • client billing
  • resource scheduling
  • expense approvals

Details

Last Updated
Nov 19, 2026
Created
Aug 15, 2025
Install Methods
dockerdocker-composebinary
Requirements
Python 3.11+PostgreSQLSQLiteNginxGunicornEventlet
Authentication
oauthoidc-sso
API
RESTWEBSOCKET
Backup & Export
native-exportdatabase-dump
Runtime / Stack
Docker
Privacy & Independence
Telemetry: Opt-outCloud: Optional
User Model
Multi-User
Deployment

Deployment: Docker Compose ✓7 Containers — heavy hosting footprintRuns as 7 containers

Run TimeTracker yourself

Pick how much you want to manage.

1 more way to host

Some links earn us a commission. netcup pays us one and is our preferred VPS host.

Is this your project? Sponsor a listing

Run TimeTracker with Docker Compose

Compose file from the TimeTracker project repository.

7 services · database: postgres · infra: nginx, postgres · 1 unclassified (ollama)

no resource limits declared

needs persistent storage (8 volumes)

docker-compose.yml · @ 600c320 · scanned Nov 3, 2026

# Default stack: app + Postgres + nginx (no local LLM). To bundle Ollama and enable the AI helper:
#   docker compose --profile ai up -d
# Set AI_ENABLED=true in .env when using --profile ai (or use a hosted openai_compatible provider only).
services:
  # Certificate generator - runs once to create self-signed certs with SANs
  certgen:
    build:
      context: .
      dockerfile: docker/Dockerfile.certgen
    container_name: timetracker-certgen
    volumes:
      - ./nginx/ssl:/certs
    environment:
      - HOST_IP=${HOST_IP:-192.168.1.100}
    command: /generate-certs.sh
    restart: "no"

  # HTTPS reverse proxy (TLS terminates here)
  nginx:
    image: nginx:alpine
    container_name: timetracker-nginx
    ports:
      - "${HTTP_PORT:-80}:80"
      - "${HTTPS_PORT:-443}:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      - ./nginx/ssl:/etc/nginx/ssl:ro
    depends_on:
      certgen:
        condition: service_completed_successfully
      app:
        condition: service_started
    restart: unless-stopped

  app:
    build: .
    container_name: timetracker-app
    environment:
      - TZ=${TZ:-Europe/Brussels}
      - CURRENCY=${CURRENCY:-EUR}
      - ROUNDING_MINUTES=${ROUNDING_MINUTES:-1}
      - SINGLE_ACTIVE_TIMER=${SINGLE_ACTIVE_TIMER:-true}
      - ALLOW_SELF_REGISTER=${ALLOW_SELF_REGISTER:-false}
      - IDLE_TIMEOUT_MINUTES=${IDLE_TIMEOUT_MINUTES:-30}
      - ADMIN_USERNAMES=${ADMIN_USERNAMES:-admin}
      # IMPORTANT: Change SECRET_KEY in production! Used for sessions and CSRF tokens.
      # Generate a secure key: python -c "import secrets; print(secrets.token_hex(32))"
      # 
      # CSRF CONFIGURATION:
      # - WTF_CSRF_SSL_STRICT: Set to 'false' for HTTP access (localhost or IP address)
      #   Set to 'true' only when using HTTPS in production
      # - If accessing via IP address (e.g., 192.168.1.100), also set:
      #   SESSION_COOKIE_SECURE=false and CSRF_COOKIE_SECURE=false
      # 
      # TROUBLESHOOTING: If forms fail with "CSRF token missing or invalid":
      # 1. Verify SECRET_KEY is set and doesn't change between restarts
      # 2. Check CSRF is enabled: WTF_CSRF_ENABLED=true
      # 3. Ensure cookies are enabled in your browser
      # 4. If behind a reverse proxy, ensure it forwards cookies correctly
      # 5. Check the token hasn't expired (increase WTF_CSRF_TIME_LIMIT if needed)
      # 6. If accessing via IP (not localhost): WTF_CSRF_SSL_STRICT=false
      # For details: docs/CSRF_CONFIGURATION.md and docs/CSRF_IP_ACCESS_GUIDE.md
      # NOTE: In production, the app refuses to start with an invalid/short SECRET_KEY.
      # Provide it via your shell env or a .env file (recommended).
      - SECRET_KEY=${SECRET_KEY:?Set SECRET_KEY to a random 32+ char string}
      # Disable strict Referer check by default to avoid privacy/port issues
      - WTF_CSRF_SSL_STRICT=${WTF_CSRF_SSL_STRICT:-true}
      - WTF_CSRF_ENABLED=${WTF_CSRF_ENABLED:-true}
      - WTF_CSRF_TIME_LIMIT=${WTF_CSRF_TIME_LIMIT:-3600}
      - SESSION_COOKIE_SECURE=${SESSION_COOKIE_SECURE:-true}
      - SESSION_COOKIE_SAMESITE=${SESSION_COOKIE_SAMESITE:-Lax}
      - REMEMBER_COOKIE_SECURE=${REMEMBER_COOKIE_SECURE:-true}
      - CSRF_COOKIE_SECURE=${CSRF_COOKIE_SECURE:-true}
      - CSRF_COOKIE_HTTPONLY=${CSRF_COOKIE_HTTPONLY:-false}
      - CSRF_COOKIE_SAMESITE=${CSRF_COOKIE_SAMESITE:-Lax}
      - CSRF_COOKIE_NAME=${CSRF_COOKIE_NAME:-XSRF-TOKEN}
      - PREFERRED_URL_SCHEME=${PREFERRED_URL_SCHEME:-https}
      - APP_BASE_URL=${APP_BASE_URL:-}
      - WTF_CSRF_TRUSTED_ORIGINS=${WTF_CSRF_TRUSTED_ORIGINS:-https://localhost}
      - DATABASE_URL=postgresql+psycopg2://timetracker:timetracker@db:5432/timetracker
      - REDIS_URL=redis://:${REDIS_PASSWORD:-timetracker}@redis:6379/0
      - REDIS_ENABLED=${REDIS_ENABLED:-false}
      - LOG_FILE=/app/logs/timetracker.log
      # Analytics & Monitoring (optional)
      # See docs/analytics.md for configuration details
      - SENTRY_DSN=${SENTRY_DSN:-}
      - SENTRY_TRACES_RATE=${SENTRY_TRACES_RATE:-0.0}
      - OTEL_EXPORTER_OTLP_ENDPOINT=${OTEL_EXPORTER_OTLP_ENDPOINT:-}
      - OTEL_EXPORTER_OTLP_TOKEN=${OTEL_EXPORTER_OTLP_TOKEN:-}
      - OTEL_DEBUG_LOGGING=${OTEL_DEBUG_LOGGING:-false}
      - ENABLE_TRACING=${ENABLE_TRACING:-true}
      - ENABLE_METRICS=${ENABLE_METRICS:-true}
      - OTEL_METRICS_EXPORT_INTERVAL_MS=${OTEL_METRICS_EXPORT_INTERVAL_MS:-60000}
      - ENABLE_TELEMETRY=${ENABLE_TELEMETRY:-false}
      - TELE_SALT=${TELE_SALT:-8f4a7b2e9c1d6f3a5e8b4c7d2a9f6e3b1c8d5a7f2e9b4c6d3a8f5e1b7c4d9a2f}
      # AI helper (off by default; use Compose profile "ai" for bundled Ollama or set AI_ENABLED=true for external API)
      - AI_ENABLED=${AI_ENABLED:-false}
      - AI_PROVIDER=${AI_PROVIDER:-ollama}
      - AI_BASE_URL=${AI_BASE_URL:-http://ollama:11434}
      - AI_MODEL=${AI_MODEL:-llama3.1}
      - AI_API_KEY=${AI_API_KEY:-}
      - AI_TIMEOUT_SECONDS=${AI_TIMEOUT_SECONDS:-60}
      - AI_CONTEXT_LIMIT=${AI_CONTEXT_LIMIT:-40}

    # Expose only internally; nginx publishes ports
    ports: []
    volumes:
      - app_data:/data
      - app_logs:/app/logs
      - app_uploads:/app/app/static/uploads
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "-s", "-o", "/dev/null", "http://localhost:8080/_health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  # Optional: Peppol Bridge (adapter) for self-hosted Peppol e-invoicing.
  # Configure via Admin → System Settings → Peppol → Setup wizard.
  peppol-bridge:
    build:
      context: .
      dockerfile: peppol_bridge/Dockerfile
    container_name: timetracker-peppol-bridge
    environment:
      - PEPPOL_BRIDGE_AUTH_TOKEN=${PEPPOL_BRIDGE_AUTH_TOKEN:-}
      - PEPPOL_BRIDGE_TIMEOUT_S=30
      # Provider preset: e-invoice.be
      - PEPPOL_BRIDGE_PROVIDER=${PEPPOL_BRIDGE_PROVIDER:-einvoice}
      - EINVOICE_BASE_URL=${EINVOICE_BASE_URL:-https://api.e-invoice.be}
      - EINVOICE_API_KEY=${EINVOICE_API_KEY:-}
      # Alternative provider: Peppyrus (free)
      - PEPPYRUS_BASE_URL=${PEPPYRUS_BASE_URL:-https://api.peppyrus.be/v1}
      - PEPPYRUS_API_KEY=${PEPPYRUS_API_KEY:-}
      # generic_custom passthrough
      - GENERIC_FORWARD_URL=${GENERIC_FORWARD_URL:-}
      - GENERIC_FORWARD_TOKEN=${GENERIC_FORWARD_TOKEN:-}
    ports: []
    restart: unless-stopped

  # Ollama - local LLM runtime for the TimeTracker AI helper (opt-in: docker compose --profile ai up -d)
  # The app talks to it via the OpenAI-compatible endpoint at /v1/chat/completions.
  # First boot pulls the model defined by AI_MODEL (default llama3.1, ~4.7 GB).
  ollama:
    profiles:
      - ai
    image: ollama/ollama:latest
    container_name: timetracker-ollama
    environment:
      - OLLAMA_HOST=0.0.0.0:11434
      - OLLAMA_KEEP_ALIVE=${OLLAMA_KEEP_ALIVE:-5m}
    volumes:
      - ollama_data:/root/.ollama
    # Internal-only by default; uncomment to expose for host tools.
    # ports:
    #   - "11434:11434"
    healthcheck:
      test: ["CMD-SHELL", "ollama list >/dev/null 2>&1 || exit 1"]
      interval: 15s
      timeout: 5s
      retries: 10
      start_period: 30s
    restart: unless-stopped

  # One-shot model puller; runs to completion on each `up` (no-op if model already cached).
  ollama-init:
    profiles:
      - ai
    image: ollama/ollama:latest
    container_name: timetracker-ollama-init
    depends_on:
      ollama:
        condition: service_healthy
    environment:
      - OLLAMA_HOST=http://ollama:11434
    entrypoint: ["/bin/sh","-c"]
    command:
      - |
        set -e
        MODEL="${AI_MODEL:-llama3.1}"
        echo "Pulling Ollama model: $$MODEL"
        ollama pull "$$MODEL"
        echo "Model ready: $$MODEL"
    restart: "no"

  db:
    image: postgres:16-alpine
    container_name: timetracker-db
    environment:
      - POSTGRES_DB=${POSTGRES_DB:-timetracker}
      - POSTGRES_USER=${POSTGRES_USER:-timetracker}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-timetracker}
      - TZ=${TZ:-Europe/Brussels}
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    restart: unless-stopped

  # Redis - Caching and session storage
  # Disabled - comment out to re-enable
  # redis:
  #   image: redis:7-alpine
  #   container_name: timetracker-redis
  #   command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD:-timetracker}
  #   volumes:
  #     - redis_data:/data
  #   ports:
  #     - "6379:6379"
  #   healthcheck:
  #     test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
  #     interval: 10s
  #     timeout: 3s
  #     retries: 5
  #   restart: unless-stopped

  # Analytics & Monitoring Services
  # All services start by default for complete monitoring
  # See docs/analytics.md and ANALYTICS_QUICK_START.md for details

  # Prometheus - Metrics collection and storage
  # Disabled - comment out to re-enable
  # prometheus:
  #   image: prom/prometheus:latest
  #   container_name: timetracker-prometheus
  #   volumes:
  #     - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml
  #     - prometheus_data:/prometheus
  #   command:
  #     - '--config.file=/etc/prometheus/prometheus.yml'
  #     - '--storage.tsdb.path=/prometheus'
  #     - '--storage.tsdb.retention.time=30d'
  #   ports:
  #     - "9090:9090"
  #   restart: unless-stopped

  # Grafana - Metrics visualization and dashboards
  # Disabled - comment out to re-enable
  # grafana:
  #   image: grafana/grafana:latest
  #   container_name: timetracker-grafana
  #   environment:
  #     - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
  #     - GF_USERS_ALLOW_SIGN_UP=false
  #     - GF_SERVER_ROOT_URL=${GF_SERVER_ROOT_URL:-http://localhost:3000}
  #   volumes:
  #     - grafana_data:/var/lib/grafana
  #     - ./grafana/provisioning:/etc/grafana/provisioning
  #   ports:
  #     - "3000:3000"
  #   depends_on:
  #     - prometheus
  #   restart: unless-stopped

  # Loki - Log aggregation
  # Disabled - comment out to re-enable
  # loki:
  #   image: grafana/loki:latest
  #   container_name: timetracker-loki
  #   volumes:
  #     - ./loki/loki-config.yml:/etc/loki/local-config.yaml
  #     - loki_data:/loki
  #   ports:
  #     - "3100:3100"
  #   command: -config.file=/etc/loki/local-config.yaml
  #   restart: unless-stopped

  # Promtail - Log shipping to Loki
  # Disabled - comment out to re-enable
  # promtail:
  #   image: grafana/promtail:latest
  #   container_name: timetracker-promtail
  #   volumes:
  #     - ./logs:/var/log/timetracker:ro
  #     - ./promtail/promtail-config.yml:/etc/promtail/config.yml
  #   command: -config.file=/etc/promtail/config.yml
  #   depends_on:
  #     - loki
  #   restart: unless-stopped

volumes:
  app_data:
    driver: local
  app_logs:
    driver: local
  app_uploads:
    driver: local
  db_data:
    driver: local
  prometheus_data:
    driver: local
  grafana_data:
    driver: local
  loki_data:
    driver: local
  redis_data:
    driver: local
  ollama_data:
    driver: local

This file may be out of date. Check the TimeTracker website for current setup steps.

Track your self-hosted stack

Bookmark software to try, rate tools you've used, and keep your collection in one place.

Metadata extracted from README on Aug 22, 2026

Alternatives to TimeTracker

Kimai logo

Kimai

5.2k
Kimai is a free and open-source professional time-tracking application for freelancers and organizations.
Time TrackingCopyleft LicenseResource Planning+2
Details
solidtime logo

solidtime

9.1k
solidtime is an open-source time tracking application for freelancers and agencies.
Time TrackingTask ManagementSelf Hosting Solutions+2
Details
Titra logo

Titra

497
titra is an open source time-tracking app for freelancers and small teams.
Dev Project ManagementTime TrackingSelf Hosting Solutions+1
Details
Traggo logo

Traggo

1.6k
A self-hosted tag-based time tracking tool with customizable dashboards, list and calendar views, and simple user management.
Time TrackingSelf Hosting SolutionsPersonal Dashboards+1
Details
TimeTagger logo

TimeTagger

1.8k
TimeTagger is an open source web-based time tracker with an interactive timeline and reporting.
Time TrackingSelf Hosting SolutionsCopyleft License
Open Core
Details
Pancake logo

Pancake

Online invoicing, project management, time tracking and proposal software.
Budgeting and FinanceTask ManagementTime Tracking+2
Details

Related Software

Ever Gauzy logo

Ever Gauzy

8.9k
Ever Gauzy Platform is an open business management platform for ERP, CRM, HRM, ATS, project management, and employee time tracking.
Time TrackingInventory ManagementResource Planning+5
2 Containers
Details
Wallos logo

Wallos

8.9k
Wallos is an open-source, self-hostable web application for tracking subscriptions, recurring expenses, and household finances.
Budgeting and FinanceCopyleft LicenseSelf Hosting Solutions+3
Details
Firefly III logo

Firefly III

25.3k
Firefly III is a self-hosted personal finance manager for tracking income, expenses, budgets, and reports.
Budgeting and FinanceSelf Hosting SolutionsPersonal Dashboards+1
Details
Kanban Tool logo

Kanban Tool

Advanced Kanban boards with time tracking.
Dev Project ManagementTask ManagementTime Tracking+2
Details
Virtual TimeClock logo

Virtual TimeClock

Powerful, easy-to-use time tracking software.
Time TrackingHR Management
Details
ProjeQtOr logo

ProjeQtOr

Complete, mature, multi-user project management system with extensive functionality for all phases of a project.
Dev Project ManagementCopyleft LicenseTask Management+3
Details
Beaver Habit Tracker logo

Beaver Habit Tracker

1.9k
A self-hosted habit tracking app without goals.
Time TrackingPermissive LicenseHealth & Fitness+2
Freemium
Details