Install Octopus Self-hosted

MSI installer

The standard way to get started on a Windows server.

Download Octopus Deploy 2026.2 (1.43 GB - Windows x64)

Chocolatey

You can also install via the command line using Chocolatey.

choco install octopusdeploy
View the Windows installation guide EULA

Docker Compose

If you don't have an SQL Server database on hand, this will set one up automatically.

docker compose up -d
Copy template configuration files (.env & docker-compose.yml)

.env

# SQL Server configuration
SA_PASSWORD=<your-sql-sa-password>
ACCEPT_EULA=Y

# Octopus Deploy configuration
ACCEPT_OCTOPUS_EULA=Y
OCTOPUS_SERVER_BASE64_LICENSE=<your-base64-license-key>
ADMIN_USERNAME=<your-admin-username>
ADMIN_PASSWORD=<your-admin-password>

# Database connection (matches the SQL Server container above)
DB_CONNECTION_STRING=Server=db,1433;Database=OctopusDeploy;User=sa;Password=<your-sql-sa-password>

docker-compose.yml

services:
  db:
    image: mcr.microsoft.com/mssql/server:latest
    environment:
      SA_PASSWORD: ${SA_PASSWORD}
      ACCEPT_EULA: ${ACCEPT_EULA}
      MSSQL_PID: Express
    ports:
      - "1401:1433"
    healthcheck:
      test: ["CMD", "/opt/mssql-tools18/bin/sqlcmd", "-S", "localhost", "-U", "sa", "-P", "$SA_PASSWORD", "-Q", "SELECT 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 20s
    volumes:
      - sqlvolume:/var/opt/mssql
  octopus-server:
    image: octopusdeploy/octopusdeploy:latest
    privileged: true
    environment:
      ACCEPT_EULA: ${ACCEPT_OCTOPUS_EULA}
      DB_CONNECTION_STRING: ${DB_CONNECTION_STRING}
      ADMIN_USERNAME: ${ADMIN_USERNAME}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
      ADMIN_EMAIL: ${ADMIN_EMAIL}
      OCTOPUS_SERVER_BASE64_LICENSE: ${OCTOPUS_SERVER_BASE64_LICENSE}
    ports:
      - "1322:8080"
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - repository:/repository
      - artifacts:/artifacts
      - taskLogs:/taskLogs
      - cache:/cache
      - import:/import
volumes:
  sqlvolume:
  repository:
  artifacts:
  taskLogs:
  cache:
  import:

Docker Run

If you have access to SQL Server, this is the easiest way to get started.

docker pull octopusdeploy/octopusdeploy:latest
docker run --interactive --detach --privileged --name OctopusDeploy --publish 1322:8080 \
  --env ACCEPT_EULA="Y" \
  --env DB_CONNECTION_STRING="Server=<your-sql-host>,1433;Database=OctopusDeploy;User=sa;Password=<your-sql-password>" \
  --env OCTOPUS_SERVER_BASE64_LICENSE="<your-base64-license-key>" \
  --env ADMIN_USERNAME="<your-admin-username>" \
  --env ADMIN_PASSWORD="<your-admin-password>" \
  octopusdeploy/octopusdeploy
View Docker installation guide EULA

Helm

Deploy to any Kubernetes cluster. mssql.enabled=”true” deploys an SQL Server container alongside Octopus.

helm upgrade my-octopus-instance oci://ghcr.io/octopusdeploy/octopusdeploy-helm \
  --install \
  --namespace octopus-deploy \
  --create-namespace \
  --set octopus.acceptEula="Y" \
  --set mssql.enabled="true" \
  --set octopus.licenseKeyBase64="<your-base64-license-key> \
  --set global.storageClass="<your-storage-class>" \
  --atomic
View Kubernetes installation guide EULA

Extend Octopus Deploy

Octopus Tentacle Required
Octopus Tentacle
By Octopus Deploy
A lightweight agent installed on your deployment targets. Required for targets you can't reach over SSH or Kubernetes.
Download
Octopus CLI
Octopus CLI
By Octopus Deploy
Manage Octopus from your terminal or scripts. Useful for automation, CI pipelines, and ad-hoc tasks from your dev environment.
Install
Octopus for GitHub
Octopus for GitHub
By Octopus Deploy
Run Octopus deployments from your GitHub Actions workflows. Includes 13 actions for package push, release creation, runbook execution, and ephemeral environments.
Browse on GitHub
Octopus for TeamCity
Octopus for TeamCity
By Octopus Deploy
Run Octopus deployments from your TeamCity builds. Push packages, create and deploy releases, and promote between environments using existing build configurations.
Get the plugin
Octopus for Azure DevOps
Octopus for Azure DevOps
By Octopus Deploy
Run Octopus deployments from Azure Pipelines or Azure DevOps Server. Includes build tasks, release tasks, and dashboard widgets for tracking project status from your DevOps homepage.
Get the extension
Octopus for Jenkins
Octopus for Jenkins
By Octopus Deploy
Run Octopus deployments from your Jenkins freestyle jobs and pipelines. Pushes packages, creates releases, deploys, and forwards build information to Octopus for end-to-end traceability.
Download
Datadog integration
Datadog integration
By Datadog
Monitor deployment performance alongside your app and infrastructure metrics. Tracks deployment time, failure rates, and pipes deployment and server logs into Datadog dashboards.
Set up