Try describing what you need:

core logo

core

★ 454

A self-hosted alternative to Jira, Trello, Asana

GNU Affero General Public License v3.0Open Source — No PaywallSingle Container — single container — minimal hosting footprintBinary · SourceNo external DB3 documented maintainers

About

Windshift is a self-hosted work management platform aimed at teams that want to plan, track, and collaborate on projects while keeping data under their own control. It combines a familiar...

Community Ratings

No ratings yet

Features

  • kanban boards
  • backlogs
  • hierarchy views
  • milestones
  • iterations
  • dashboards
  • custom workflows
  • rich descriptions and comments
  • public boards
  • customer portal

Details

Last Updated
Nov 18, 2026
Created
Dec 15, 2025
Install Methods
binarysource
Requirements
GoSQLitePostgreSQL
Default Port
8080From the project's Compose file
Authentication
oidc-sso
Backup & Export
file-backup
Privacy & Independence
No Cloud Required
User Model
Multi-User
Theming
Dark mode
Deployment

Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container

Run core 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 core with Docker Compose

Compose file from the core project repository.

1 service

≈2.0 GB RAM requested (from Docker memory limits)

needs persistent storage (1 volume)

deploy/docker-compose.yml · @ 84e503f · scanned Nov 3, 2026

# Windshift Production Docker Compose Configuration
#
# Quick Start:
#   1. Run ./init.sh to generate .env file with SSO_SECRET
#   2. Edit .env and set DOMAIN to your hostname
#   3. Run: docker compose up -d
#
# For PostgreSQL: Uncomment the postgres service and related environment variables
# For Traefik: Uncomment the traefik service and labels on windshift service

services:
  windshift:
    image: ghcr.io/windshiftapp/windshift:latest
    container_name: windshift
    # Each live item-detail viewer holds an SSE connection (WI-484); the default
    # 1024 fd limit is the failure point near ~1000 concurrent streams.
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    ports:
      - "${PORT:-8080}:8080"
    environment:
      - BASE_URL=https://${DOMAIN}
      - PORT=8080
      - USE_PROXY=true
      - SSO_SECRET=${SSO_SECRET}
      - SESSION_IP_BINDING=${SESSION_IP_BINDING:-log}
      - ATTACHMENT_PATH=/data/attachments
      - DB_PATH=/data/windshift.db
      - LOG_LEVEL=info
      - LOG_FORMAT=json
      # OPTIONAL: accept self-signed certificates for outbound TLS connections
      # (SMTP, IMAP, LDAP, HTTPS integrations). This disables server identity
      # verification; leave false unless every destination network is trusted.
      - TLS_SKIP_VERIFY=${TLS_SKIP_VERIFY:-false}
      # Total process budget. Keep the container limit below in sync.
      - WINDSHIFT_MEMORY_LIMIT_MB=${WINDSHIFT_MEMORY_LIMIT_MB:-2048}
      - DISABLE_PLUGINS=${DISABLE_PLUGINS:-false}
      - PLUGIN_DIR=/data/plugins
      - ENABLE_ADMIN_FALLBACK=${ENABLE_ADMIN_FALLBACK:-false}
      # Temp directories for SQLite in scratch containers
      - TMPDIR=/tmp
      - SQLITE_TMPDIR=/tmp
      # --- Web Push (VAPID) for mobile/PWA push notifications ---
      # OPTIONAL: leave unset and the server auto-generates a keypair on first
      # boot and persists it in the database — push works with no setup. Set
      # these only to manage/rotate keys yourself (keep the pair stable;
      # rotating invalidates every existing subscription):
      #   npx web-push generate-vapid-keys   # then put them in .env
      - VAPID_PUBLIC_KEY=${VAPID_PUBLIC_KEY:-}
      - VAPID_PRIVATE_KEY=${VAPID_PRIVATE_KEY:-}
      # Optional VAPID "sub" contact (mailto: or https:). Defaults to BASE_URL.
      - VAPID_SUBJECT=${VAPID_SUBJECT:-}
      # --- PostgreSQL (uncomment when using postgres service) ---
      # - DB_TYPE=postgres
      # - POSTGRES_HOST=postgres
      # - POSTGRES_PORT=5432
      # - POSTGRES_USER=windshift
      # - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      # - POSTGRES_DB=windshift
      # - POSTGRES_SSLMODE=disable
      # PostgreSQL connection budget:
      # replicas × (MAX_READ_CONNS + 5 when SSH is enabled) + headroom
      # must not exceed PostgreSQL max_connections. Windshift validates this
      # declared budget at startup and exposes it in Admin → Diagnostics.
      # - MAX_READ_CONNS=30
      # - POSTGRES_REPLICA_COUNT=1
      # - POSTGRES_CONNECTION_HEADROOM=10
      # --- LLM (uncomment when using llm service) ---
      # - LLM_ENDPOINT=http://llm:8081
      # --- Coding agents (uncomment the windshift-runner service + coding-agent
      #     network below). Windshift orchestrates only — it queues runs and
      #     serves the runner pool; agents execute on the windshift-runner host,
      #     never here. Enable the feature with --enable-coding-agent /
      #     CODING_AGENT_ENABLED=true. The in-network URL lets the runner reach
      #     Windshift over the internal egress network: ---
      # - CODING_AGENT_ENABLED=true
      # - CODING_AGENT_WS_API_URL=http://windshift:8080/api
    volumes:
      - windshift-data:/data
    # tmpfs for /tmp - the scratch image has no /tmp. Needed for SQLite WAL
    # mode. Short syntax on purpose - the long-syntax "mode: 1777" is parsed as
    # DECIMAL (mounts as 03361); the short form defaults to a correct sticky
    # 1777.
    tmpfs:
      - /tmp:exec,size=64M
    restart: unless-stopped
    mem_limit: ${WINDSHIFT_CONTAINER_MEMORY_LIMIT:-2g}
    # --- Traefik labels (uncomment when using traefik service) ---
    # labels:
    #   - "traefik.enable=true"
    #   - "traefik.http.routers.windshift.rule=Host(`${DOMAIN}`)"
    #   - "traefik.http.routers.windshift.entrypoints=websecure"
    #   - "traefik.http.routers.windshift.tls.certresolver=letsencrypt"
    #   - "traefik.http.services.windshift.loadbalancer.server.port=8080"
    # --- Networks: keep ONE list with every network windshift joins. Listing
    #     any network here removes the implicit default — keep "default". ---
    # networks:
    #   - default
    #   - traefik          # with the traefik service
    #   - coding-agent     # with a coding-agent flavor (internal egress network)
    depends_on: []
      # --- PostgreSQL dependency (uncomment when using postgres service) ---
      # postgres:
      #   condition: service_healthy
      # --- LLM dependency (uncomment when using llm service) ---
      # llm:
      #   condition: service_healthy

  # ---------------------------------------------------------------------------
  # Coding-agent runner (uncomment to run coding-agent jobs on this host)
  # ---------------------------------------------------------------------------
  # Co-locates the windshift-runner worker with Windshift so the whole
  # coding-agent stack lives in this one compose file. Agent containers are
  # spawned into the coding-agent network declared at the bottom; because that
  # network is INTERNAL, agents and the runner can reach only Windshift —
  # no host firewall / egress-allowlist rules are needed (LLM and git traffic
  # is brokered through Windshift's proxies).
  #
  # When using the runner:
  #   1. Uncomment this service, the coding-agent network at the bottom, and
  #      on the windshift service above: the networks list and
  #      CODING_AGENT_WS_API_URL=http://windshift:8080/api
  #   2. Start Windshift, mint a pool registration token (Admin -> Runner
  #      Pools), set it in .env as WSRUNNER_REGISTRATION_TOKEN
  #   3. docker compose up -d
  # ---------------------------------------------------------------------------
  # windshift-runner:
  #   image: ghcr.io/windshiftapp/windshift-runner:latest
  #   container_name: windshift-runner
  #   environment:
  #     # In-compose control plane. Plaintext HTTP is acceptable only because
  #     # the traffic never leaves this host's docker bridge.
  #     WS_API_URL: http://windshift:8080/api
  #     WSRUNNER_ALLOW_INSECURE: "1"
  #     WSRUNNER_REGISTRATION_TOKEN: ${WSRUNNER_REGISTRATION_TOKEN}
  #     WSRUNNER_IMAGE: ghcr.io/windshiftapp/windshift-agent:latest
  #   volumes:
  #     # Drive the host docker daemon (spawns the sandboxed agent containers).
  #     - /var/run/docker.sock:/var/run/docker.sock
  #     # SAME path on host and in-container: the host daemon — not this
  #     # container — bind-mounts each prepared checkout into the agent
  #     # container, so the path must resolve identically on the host.
  #     - /var/lib/windshift-runner:/var/lib/windshift-runner
  #   networks:
  #     - coding-agent
  #   depends_on:
  #     - windshift
  #   restart: unless-stopped

  # ---------------------------------------------------------------------------
  # PostgreSQL (uncomment to use instead of SQLite)
  # ---------------------------------------------------------------------------
  # When using PostgreSQL:
  #   1. Uncomment this service
  #   2. Uncomment the DB_* environment variables in windshift service above
  #   3. Uncomment the depends_on section in windshift service
  #   4. Set POSTGRES_PASSWORD in your .env file
  #   5. Uncomment postgres-data volume below
  # ---------------------------------------------------------------------------
  # postgres:
  #   image: postgres:18
  #   container_name: windshift-postgres
  #   environment:
  #     POSTGRES_USER: windshift
  #     POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
  #     POSTGRES_DB: windshift
  #   volumes:
  #     - postgres-data:/var/lib/postgresql/data
  #   restart: unless-stopped
  #   healthcheck:
  #     test: ["CMD-SHELL", "pg_isready -U windshift -d windshift"]
  #     interval: 5s
  #     timeout: 5s
  #     retries: 5

  # ---------------------------------------------------------------------------
  # Traefik Reverse Proxy (uncomment for built-in HTTPS with Let's Encrypt)
  # ---------------------------------------------------------------------------
  # When using Traefik:
  #   1. Uncomment this service
  #   2. Uncomment the labels and networks in windshift service above
  #   3. Set TRAEFIK_HOST and LETSENCRYPT_EMAIL in your .env file
  #   4. Uncomment the traefik network below
  #   5. Remove or comment out the ports section in windshift service
  # ---------------------------------------------------------------------------
  # traefik:
  #   image: traefik:v3.0
  #   container_name: windshift-traefik
  #   command:
  #     - "--api.dashboard=false"
  #     - "--providers.docker=true"
  #     - "--providers.docker.exposedbydefault=false"
  #     - "--entrypoints.web.address=:80"
  #     - "--entrypoints.web.http.redirections.entrypoint.to=websecure"
  #     - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
  #     - "--entrypoints.websecure.address=:443"
  #     - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
  #     - "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web"
  #     - "--certificatesresolvers.letsencrypt.acme.email=${LETSENCRYPT_EMAIL}"
  #     - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
  #   ports:
  #     - "80:80"
  #     - "443:443"
  #   volumes:
  #     - "/var/run/docker.sock:/var/run/docker.sock:ro"
  #     - "traefik-certs:/letsencrypt"
  #   restart: unless-stopped
  #   networks:
  #     - traefik

  # ---------------------------------------------------------------------------
  # Local LLM Inference (uncomment for AI features like "Plan My Day")
  # ---------------------------------------------------------------------------
  # When using the LLM service:
  #   1. Uncomment this service
  #   2. Uncomment the LLM_ENDPOINT environment variable in windshift service above
  #   3. Uncomment the depends_on llm section in windshift service
  # Note: Container needs ~2 GB RAM (1.25 GB model + KV cache + overhead)
  # ---------------------------------------------------------------------------
  # llm:
  #   build:
  #     context: ..
  #     dockerfile: deploy/Dockerfile.llm
  #   # image: ghcr.io/windshiftapp/llm:latest
  #   container_name: windshift-llm
  #   environment:
  #     LLM_PORT: 8081
  #     LLM_CTX_SIZE: 4096
  #     LLM_THREADS: ${LLM_THREADS:-4}
  #     LLM_PARALLEL: 2
  #   restart: unless-stopped
  #   healthcheck:
  #     test: ["CMD", "curl", "-f", "http://localhost:8081/health"]
  #     interval: 15s
  #     timeout: 5s
  #     retries: 3
  #     start_period: 120s

  # ---------------------------------------------------------------------------
  # Logbook Service — UNMAINTAINED. The ghcr.io/windshiftapp/logbook image is
  # no longer published; do not enable for new deployments. Source remains
  # in-tree but is not built in CI.
  # ---------------------------------------------------------------------------
  # When using the Logbook service:
  #   1. Uncomment this service and the logbook-postgres service below
  #   2. Add LOGBOOK_ENDPOINT=http://logbook:8090 to windshift environment above
  #   3. Optionally configure LOGBOOK_LLM_ENDPOINT for article generation
  #   4. The main server authenticates users and proxies to logbook with trusted headers
  # Note: Requires system tools (poppler, kreuzberg-cli) for text extraction
  # ---------------------------------------------------------------------------
  # logbook:
  #   image: ghcr.io/windshiftapp/logbook:latest
  #   # build:
  #   #   context: ..
  #   #   dockerfile: Dockerfile.logbook
  #   container_name: windshift-logbook
  #   environment:
  #     LOGBOOK_DATABASE_URL: postgresql://logbook:${LOGBOOK_POSTGRES_PASSWORD}@logbook-postgres:5432/logbook?sslmode=disable
  #     LOGBOOK_LLM_ENDPOINT: http://llm:8081
  #     LOGBOOK_ARTICLE_ENDPOINT: http://windshift:8080/api/internal/llm
  #     WINDSHIFT_URL: http://windshift:8080
  #     SSO_SECRET: ${SSO_SECRET}
  #     LOGBOOK_PORT: 8090
  #     LOGBOOK_STORAGE_PATH: /data/logbook
  #     LOG_LEVEL: info
  #   volumes:
  #     - logbook-data:/data/logbook
  #     # The logbook pre-warms and uses a kreuzberg model cache at /root/...
  #     # on the kreuzberg-cli base image. Running read-only requires tmpfs
  #     # mounts for everything the process writes at runtime.
  #     - type: tmpfs
  #       target: /tmp
  #       tmpfs:
  #         size: 128M
  #         mode: 1777
  #   # Hardening: the logbook runs untrusted parsers (poppler, kreuzberg with
  #   # OCR/layout models) on user-uploaded files. Drop everything the process
  #   # does not need so a parser RCE has minimal room to pivot.
  #   user: "65534:65534"
  #   read_only: true
  #   cap_drop:
  #     - ALL
  #   security_opt:
  #     - no-new-privileges:true
  #   pids_limit: 512
  #   mem_limit: 2g
  #   cpus: 2.0
  #   depends_on:
  #     logbook-postgres:
  #       condition: service_healthy
  #   expose:
  #     - "8090"
  #   restart: unless-stopped
  #   healthcheck:
  #     test: ["CMD", "curl", "-f", "http://localhost:8090/api/logbook/health"]
  #     interval: 10s
  #     timeout: 5s
  #     retries: 3
  #     start_period: 10s

  # ---------------------------------------------------------------------------
  # Logbook PostgreSQL (uncomment when using logbook service)
  # ---------------------------------------------------------------------------
  # logbook-postgres:
  #   image: postgres:18
  #   container_name: windshift-logbook-postgres
  #   environment:
  #     POSTGRES_USER: logbook
  #     POSTGRES_PASSWORD: ${LOGBOOK_POSTGRES_PASSWORD}
  #     POSTGRES_DB: logbook
  #   volumes:
  #     - logbook-postgres-data:/var/lib/postgresql/data
  #   restart: unless-stopped
  #   healthcheck:
  #     test: ["CMD-SHELL", "pg_isready -U logbook -d logbook"]
  #     interval: 5s
  #     timeout: 5s
  #     retries: 5

volumes:
  windshift-data:
    name: windshift-data
  # --- PostgreSQL volume (uncomment when using postgres service) ---
  # postgres-data:
  #   name: windshift-postgres-data
  # --- Logbook volumes (uncomment when using logbook service) ---
  # logbook-data:
  #   name: windshift-logbook-data
  # logbook-postgres-data:
  #   name: windshift-logbook-postgres-data
  # --- Traefik certificates volume (uncomment when using traefik service) ---
  # traefik-certs:
  #   name: windshift-traefik-certs

# --- Networks: keep ONE top-level networks block; uncomment the entries you
#     use. ---
# Traefik network: uncomment with the traefik service.
# Coding-agent egress network: uncomment with either coding-agent flavor. The
# fixed name matches the network agent containers are spawned into.
# "internal: true" is the whole egress story: containers on it reach each
# other (i.e. Windshift) but nothing else — it replaces the firewalld /
# iptables allowlist in deploy/coding-agent/README.md.
# networks:
#   traefik:
#     name: windshift-traefik
#   coding-agent:
#     name: coding-agent-egress
#     internal: true

This file may be out of date. Check the core documentation 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 Oct 5, 2026

Alternatives to core

Wekan logo

Wekan

21.2k
WeKan is a self-hosted, open-source collaborative kanban application for organizing tasks and projects on boards.
Task ManagementPermissive LicenseDev Project Management+1
2 ContainersOpen Core
Details
Kanboard logo

Kanboard

10.0k
Kanboard is project management software focused on the Kanban methodology.
Task ManagementPermissive LicenseDev Project Management+1
2 Containers
Details
Planka logo

Planka

12.7k
Planka is a self-hostable collaborative Kanban board application for project and task management.
Task ManagementCopyleft LicenseDev Project Management+2
Open Core
Details
OpenProject logo

OpenProject

17.5k
OpenProject is a web-based open source project management platform for teams and organizations.
Dev Project ManagementTask ManagementResource Planning+5
Open CoreFully FOSS
Details
Kanban Tool logo

Kanban Tool

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

Kaneo

9.8k
Kaneo is a self-hosted project management platform with a clean, fast interface.
Dev Project ManagementPermissive LicenseTask Management+1
2 Containers
Details
Plane logo

Plane

62.7k
Plane is an open-source project management tool for tracking issues, running cycles, and managing product roadmaps.
Dev Project ManagementCopyleft LicenseSelf Hosting Solutions+4
13 ContainersFOSS with Issues
Details
Kan logo

Kan

6.0k
Kan is an open-source project management alternative to Trello.
Task ManagementDev Project ManagementSelf Hosting Solutions+2
3 ContainersFully FOSS
Details
Taiga logo

Taiga

Agile Project Management Tool based on the Kanban and Scrum methods.
Dev Project ManagementTask ManagementSelf Hosting Solutions+1
Details
Focalboard logo

Focalboard

26.6k
Focalboard is an open source, self-hosted project management tool for tracking and organizing work.
Task ManagementDev Project ManagementKnowledge Management+3
Details
4ga Boards logo

4ga Boards

743
A straightforward realtime project management boards system with hierarchy, Markdown editing, and import/export support.
Task ManagementDev Project ManagementPermissive License+2
3 Containers
Details
Redmine logo

Redmine

Flexible project management web application.
Dev Project ManagementCopyleft LicenseTask Management+4
Details

Related Software

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
Trac logo

Trac

Enhanced wiki and issue tracking system for software development projects.
Dev Project ManagementPermissive LicenseWikis+2
Details
ShipShipShip logo

ShipShipShip

305
A self-hostable changelog and roadmap platform with emoji reactions, themes, newsletters, and an admin dashboard.
Dev Project ManagementPermissive LicenseStatus Pages+2
Single Container
Details