Skip to navigation
Skip to main content
Skip to footer
Docs
Light
Dark
Light
Dark
Introduction
Getting started
Overview
First Deployment
First Deployment
Define and use variables
Approvals with Manual Interventions
Add deployment targets
Deploy a sample package
First Runbook Run
First Runbook Run
Configure Runbook Environments
Create a Project
Create a runbook
Defining the runbook process for workers
Running a Runbook
Runbook specific variables
Add runbook deployment targets
Defining the runbook process for targets
Publishing a runbook
Managing Octopus subscriptions
Samples
Reference architectures
Reference architectures
EKS reference architecture
Web App reference architecture
Glossary
Octopus Cloud
Overview
Getting started with Cloud
Migrating to Octopus Cloud
Static IP address
Dynamic workers
Task cap
Azure Private Links
IP address allow list
Uptime SLO
Maintenance windows
Disaster recovery
Permissions
Octopus Cloud FAQ
Installation
Overview
Installation requirements
SQL Database
Overview
Self-Managed SQL Server
AWS RDS
Azure SQL
GCP Cloud SQL
File Storage
Overview
Local File Storage
AWS File Storage
Azure Files
GCP File Storage
Windows NFS File Storage
Load Balancers
Overview
Configuring Netscaler
Use NGINX as a reverse proxy for Octopus Deploy
Use IIS as a reverse proxy for Octopus Deploy
AWS Load Balancers
Azure Load Balancers
GCP Load Balancers
Permissions for the Octopus Windows Service
Using a Managed Service Account (MSA)
Automating Octopus installation
Troubleshooting the Octopus installation
Octopus Server Linux Container
Octopus Server Linux Container
Octopus Server Container with Docker Compose
Octopus Server Container with systemd
Octopus Server in Kubernetes
Migration
Migration
Migrate to Octopus Server Linux Container from Windows Server
Migrate to Octopus Server Linux Container from Windows Container
Troubleshooting Octopus Server in a Container
Isolated Octopus Servers
Best Practices
Overview
Deployments
Overview
Environments, Deployment Targets, and Target Tags
Lifecycles and Environments
Projects and Project Groups Structure
Variable Recommendations
Step Templates and Script Modules
Deployment and Runbook Processes
Releases and Deployments
Notifications
Octopus Administration
Overview
Partition Octopus with Spaces
Offload Work to Workers
Users, Roles, and Teams
Ongoing Maintenance
Self-Hosted Octopus
Overview
Installation Guidelines
High Availability
Disaster Recovery
Platform Engineering
Overview
What is platform engineering?
Octopus enterprise patterns
Managing Octopus with code
Managing space resources
Managing project resources
Managing runbook resources
Forking Git repositories
Finding drift
Merging repos
Validating CaC PRs
Secret variables
Octopus AI
Overview
Octopus AI Assistant
Overview
Getting started
Cookbook
Overview
Analyze step template usage
Audit environment naming and counts
Audit PCI deployments
Audit target role distribution
Check retention policy consistency
Create a .NET Azure App deployment process
Detect overlapping variable names
Detect unused variables
Evaluate deployment frequency
Fix variable binding errors
Generate deployment rollback plan
Improve multi-tenant deployments
Investigate production deployment failure
Kubernetes deployment pipeline
List failed deployments
Recommend variable scoping
Report runbook scheduling
Report skipped steps
Resolve rolling deployment timeouts
Restart Windows services Runbook
Review runbook usage
Security best practices check
Speed up Lifecycle phases
Summarize Ops Runbooks
Summarize tag set coverage
Summarize worker pool health
Best Practices Adviser
Deployment failure analyzer
Prompt-based project creation
Custom prompts
Octopus MCP
Overview
Use Cases
Octopus Recovery Agent
Kubernetes
Overview
Targets
Overview
Kubernetes agent
Overview
Permissions
Granular Permissions
Kubernetes Monitor
Storage
Automated Installation
HA Cluster Support
Upgrading
Troubleshooting
General Troubleshooting
SHA1 Certificates on older Windows versions
Default images
Supported Versions Policy
Kubernetes API
Overview
OpenShift Kubernetes cluster
Rancher Kubernetes cluster
Steps
Overview
Deploy Kubernetes YAML
Deploy a Helm chart
Deploy with Kustomize
Configure and apply Kubernetes resources
Configure and apply a Kubernetes Service
Configure and apply a Kubernetes Ingress
Deployment Verification
Step Verification
Applied Manifests
Overview
Diffs
Resources
Glob Pattern Cheat Sheet
Server-Side Apply
kubectl
Tutorials
First Kubernetes deployment
Rollback Kubernetes deployment
Automatically tracking third party helm charts
Live Object Status
Overview
Installation
Troubleshooting
Argo CD
Overview
Argo CD Instances
Overview
Argo CD Authentication
Automated Installation
Deployment Steps
Overview
Update Argo CD Application Image Tags
Update Argo CD Application Manifests
Annotated Application View
Annotations
Scoping Annotations
Cluster Annotations
Helm Annotations
Supported Use Cases
Live Object Status
Troubleshooting
Infrastructure
Overview
Deployment targets
Deployment targets
Counting deployment targets
Target tags
Octopus Tentacle
Octopus Tentacle
Windows Tentacle
Windows Tentacle
Tentacle installation requirements
Tentacle installation requirements
Legacy Tentacle installation requirements
Permissions required for the Tentacle Windows Service
Running Tentacle under a specific user account
Clustered Listening Tentacles
Automating Tentacle installation
Polling Tentacles over WebSockets
Azure virtual machines
Azure virtual machines
Installing the Tentacle via DSC in an ARM template
Installing the Tentacle VM extension via the Azure Portal
Installing the Tentacle VM extension via the classic Azure Portal
Installing the Tentacle VM extension via PowerShell
Installing the Tentacle VM extension via the Azure CLI
Tentacle VM extension configuration structure
Diagnosing Tentacle VM extension issues
Linux Tentacle
Tentacle communication modes
Octopus Tentacle in a Container
Polling Tentacles over Standard HTTPS Port
Agent vs Agentless
Troubleshooting Tentacles
Troubleshooting Tentacles
Troubleshooting Listening Tentacles
Troubleshooting Polling Tentacles
Linux targets
Linux targets
SSH target
SSH target requirements
SSH deployments
Sudo commands
Amazon ECS cluster
Azure targets
Azure targets
Azure Service Fabric cluster targets
Azure Web App targets
Offline package drop
Cloud regions
Cloud Target Discovery
Dynamic infrastructure
Dynamic infrastructure
Create AWS account command
Create Azure Service Principal account command
Create token account command
Create username/password command
Create Azure Web App target command
Create Azure Service Fabric target command
Create Kubernetes Target Command
New Octopus Target Command
Remove Octopus Target Command
Machine policies
Proxy support
Environments
Environments
Environment recommendations
Accounts
Accounts
Azure
AWS accounts
Google cloud accounts
SSH key pair account
Token account
Username and password accounts
OpenID Connect
Workers
Workers
Built-in Worker
Kubernetes Worker
Kubernetes Worker
Storage
Cluster Configuration
Scaling Behavior
Automated Installation
Troubleshooting
Worker pools
Dynamic Worker pools
Dynamic Worker pools
Ubuntu 18.04 End-of-life
Windows 2019 End-of-life
Worker Tools, Versioning and Caching
Git credentials
Signing Keys
Ephemeral Environments
Platform Hub
Overview
Process Templates
Overview
Troubleshooting
Best Practices
Policies
Getting started
Examples
Schema for policies
Best Practices
Troubleshooting
Packaging applications
Overview
Create packages
Create packages
Versioning schemes
Create packages with the Octopus CLI
Create packages with OctoPack
Create packages with OctoPack
Include BuildEvent files
Troubleshooting OctoPack
Build server integration
Build server integration
Build information
AppVeyor integration
Azure DevOps
Azure DevOps
Using the Octopus extension
Using the Octopus extension
Build versions and packaging in Azure DevOps
Azure DevOps and Team Foundation Server Extension Version Compatibility
Installing the Octopus CLI as a capability
Bamboo
BitBucket Pipelines
Codefresh Pipelines
Continua CI
GitHub Actions
Jenkins
Jenkins
Jenkins Pipeline projects
TeamCity
Troubleshooting build server integrations
Package repositories
Package repositories
Built-in Octopus repository
Docker Container Registry
Docker Container Registry
Octopus versioning scheme
GitHub Repository feeds
Maven feeds
NuGet feeds
Artifactory Generic Feeds
Guides
Guides
Container registries
Container registries
Artifactory container registry
AWS Elastic Container Registry (ECR)
Azure Container Registry
Docker Hub
GitLab container registry
Google Cloud Container Registry (GCR)
Nexus Container Registry
Oracle Cloud Infrastructure Container Registry
ProGet Container Registry
NuGet repositories
NuGet repositories
Artifactory Local NuGet repository
Azure DevOps and TFS package management
GitHub NuGet repository
GitLab NuGet repository
Nexus Hosted NuGet repository
ProGet NuGet repository
Maven repositories
Maven repositories
Nexus Hosted Maven repository
GitLab Maven repository
ProGet Maven repository
Artifactory Maven repository
Cloudsmith Multi-format repositories
AWS S3 Bucket feeds
Projects
Overview
Deployment process
Deployment process
Artifacts
Performance
Setting up projects and project groups
Project dashboard
Project recommendations
Steps
Steps
Configuration features
Configuration features
Custom installation directory
IIS websites and application pools
Windows Services
Structured configuration variables
.NET XML configuration variables feature
.NET Configuration transforms
.NET Configuration transforms