Skip to navigation Skip to main content Skip to footer
Docs
  • 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
    • 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
  • 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
  • Kubernetes
    • Overview
    • Targets
      • Overview
      • Kubernetes agent
        • Overview
        • 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
      • Kubernetes Object Status
      • 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
  • 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
        • Troubleshooting 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
  • 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
          • Environment specific .NET configuration transforms with sensitive values
          • Troubleshooting .NET configuration transforms
        • Substitute variables in templates
        • NGINX Web Server
      • Conditions
      • Execution containers for workers
    • Built-in step templates
      • Built-in step templates
      • Email notification step
      • Manual intervention and approval step
      • Health check step
      • Automatic step template updates
    • Exporting and Importing Projects
    • Community step templates
    • Custom step templates
      • Custom step templates
      • Custom step templates stored in Git
    • Updating step templates
    • Variables
      • Variables
      • Getting started with variables
      • Variable substitutions
      • Variable filters
      • System variables
      • Output variables
      • Prompted variables
      • Sensitive variables
      • Certificate variables
      • Worker Pool variables
      • Google Cloud account variables
      • Azure account variables
      • AWS account variables
      • Username and password account variables
      • Tenant variables
      • Variable sets
    • Tenants
      • Overview
      • Bulk connection
    • Project triggers
      • Project triggers
      • Deployment target triggers
      • Scheduled deployment triggers
      • External feed triggers
      • Built-in package repository triggers
      • Git repository triggers
    • Coordinating multiple projects
      • Coordinating multiple projects
      • Project coordination code samples
      • Deploy a release step
    • Configuration as Code
      • Configuration as Code
      • Converting projects to Git
        • Converting projects to Git
        • Migrating variables to Git
      • Configuration as Code reference
      • Editing a project with version control enabled
      • GitHub integration
      • Creating and deploying releases on a version-controlled project
      • Creating releases from a build server plugin on a version-controlled project
      • Unsupported Configuration as Code Scenarios
      • Moving version control
      • OCL Syntax for Config as Code
  • Tenants
    • Overview
    • Tenant types
    • Tenant creation
      • Tenant creation
      • Tenanted deployments
      • Connecting projects
    • Tenant variables
    • Tenant tags
    • Tenant infrastructure
    • Tenant lifecycles
    • Tenant roles and security
    • Multi-tenant deployment guides
      • Multi-tenant deployment guides
      • Multi-tenant regions
      • Multi-tenant SaaS applications
      • Multi-tenant teams
        • Multi-tenant teams
        • Creating new tenants
        • Assigning a team to a tenant
        • Deploying to a team tenant
      • Tenants sharing machine targets
        • Tenants sharing machine targets
        • Creating the tenant tag set
        • Assign tags to tenants
        • Assign tags to targets
        • Deploying before the concurrency tag is changed
        • Setting the Concurrency Tag
        • Deploying after the concurrency tag is changed
        • Summary and FAQ
    • Multi-tenant deployments FAQ
    • Troubleshooting multi-tenant deployments
  • Releases
    • Overview
    • Creating a release
    • Lifecycles
    • Channels
    • Guided failures
    • Prevent release progression
    • Deleting releases
    • Manually fail a task
    • Issue trackers
      • Issue trackers
      • Jira issue tracking
      • GitHub issue tracking integration
      • Azure DevOps work item tracking integration
    • Release versioning
    • Deployment changes
    • Deployment Timeline
    • Release notes
  • Deployments
    • Overview
    • AWS
      • AWS
      • Amazon S3 Create Bucket
      • Deploy an AWS CloudFormation template
      • Update Amazon ECS Service
      • Deploy Amazon ECS Service
      • AWS permissions required by Octopus
      • Delete an existing AWS CloudFormation stack
      • Upload to AWS S3 template
    • Google Cloud
      • Google Cloud
      • Google cloud CLI scripts
    • Azure
      • Azure
      • Azure Service Fabric
        • Azure Service Fabric
        • Packaging a Service Fabric application
        • Deploying a package to an Azure Service Fabric cluster
        • Version automation with Service Fabric application packages
        • Connecting securely with client certificates
        • Connecting securely with Azure Active Directory
      • Varying Azure subscription by environment
      • Azure environments
      • Azure app service environments
      • Deploying to Azure via a firewall
      • Azure web apps
        • Azure web apps
        • Deploying Web Jobs
        • Using Deployment Slots with Azure Web Apps
      • Running Azure PowerShell
        • Running Azure PowerShell
        • Configuring the version of the Azure CLI
        • Configuring the version of the Azure PowerShell Modules
    • .NET deployments
      • .NET deployments
      • ASP.NET Core webapp
    • Docker Containers
      • Docker Containers
      • Accessing container details
      • Docker run with networking
    • Windows
      • Windows
      • Windows Services
      • IIS Websites and application pools
      • Virtual hard drives
    • Certificates
      • Certificates
      • Add a certificate to Octopus
      • Certificate chains
      • Import certificate to Windows certificate store
      • Import certificates into Tomcat
      • Import certificates into WildFly and JBoss EAP
      • Export a certificate
      • Export a certificate to a Java KeyStore
      • Replace a certificate
      • Archive and delete certificates
      • Troubleshooting invalid certificates
    • Databases
      • Databases
      • Database configuration
        • Database configuration
        • Install Tentacles and Workers for database deployments
        • Recommended database permissions
      • SQL Server deployments
        • SQL Server deployments
        • SQL Server permissions
        • SQL Server DACPAC deployment
        • Deploy to SQL Server using Redgate SQL change automation
      • Common patterns
        • Common patterns
        • Manual approvals
        • Automatic approvals
        • Ad-hoc data change scripts
        • Database backups and rollbacks
      • MySQL flyway deployment
    • Terraform
      • Terraform
      • Preparing your Terraform environment
      • Terraform step configuration
      • Planning changes made by Terraform templates
      • Applying changes from Terraform templates
      • Terraform output variables
      • Terraform plugin cache
    • Java applications
      • Java applications
      • Deploying a sample Java application
      • Java error messages and troubleshooting
    • NGINX deployments
      • NGINX deployments
      • Configuring target machine
      • Create and push an ASP.NET Core project
      • Configure Octopus Deploy project
    • Node deployments
      • Node deployments
      • Deploying Node applications to Linux
    • Packages
      • Packages
      • Dynamically selecting packages at deployment time
      • Delta compression for package transfers
      • Stage package uploads
      • Package deployment feature ordering
      • Deploying packages to your Octopus Server
      • Transfer package
      • Troubleshoot missing packages
    • Custom scripts
      • Custom scripts
      • Run a script step
      • Scripts in packages
        • Scripts in packages
        • Reference files within a package
      • Using variables in scripts
      • Passing parameters to scripts
      • Logging messages from scripts
      • Error handling
      • Output variables
      • Raw scripting
      • Azure CLI and PowerShell Scripts
      • AWS CLI and PowerShell scripts
      • Service Fabric PowerShell scripts
      • PowerShell Core
      • Debugging PowerShell scripts
        • Debugging PowerShell scripts
        • Debugging PowerShell scripts on remote machines
      • Script modules
    • HTML and JavaScript applications
    • Bulk deployment creation
    • Deployment freezes
      • Deployment freezes
      • Project deployment freezes
    • Patterns and practices
      • Patterns and practices
      • Rolling deployments
      • Blue-green deployments in Octopus using Environments
        • Blue-green deployments in Octopus using Environments
        • Blue-green deployments in IIS
      • Rollbacks
        • Rollbacks
        • Rollback .NET Application on Windows Server
        • Rolling back a Tomcat deployment
        • Rolling back an NGINX deployment
      • Multi-region deployment pattern
      • Elastic and transient environments
        • Elastic and transient environments
        • Deploying to Transient Targets
        • Keeping deployment targets up to date
        • Cleaning up Environments
        • Immutable Infrastructure
      • Canary deployments
      • Branching
      • Deployment process as code
  • Runbooks
    • Overview
    • Runbooks vs Deployments
    • Config as Code runbooks
    • Runbooks permissions
    • Runbook variables
    • Runbooks publishing
    • Scheduled runbook triggers
    • Runbooks examples
      • Runbooks examples
      • Routine operations
        • Routine operations
        • IIS Runbooks
        • Install software with Chocolatey
        • Updating Windows
        • Updating Linux
        • Hardening Windows
        • Hardening an Ubuntu server
        • Installing Apache
        • Hardening Apache runbook
        • Install NGINX
        • Installing Tomcat on Ubuntu
        • Restarting a Tomcat Web application
        • Renew Let's Encrypt certificates
        • Services Runbooks
      • Emergency operations
        • Emergency operations
        • Manually failover DNS
        • Automatically failover DNS with monitoring
        • Restart server
      • Database examples
        • Database examples
        • Backup SQL database
        • Restore SQL database
        • Restore SQL database to another environment
        • Create MySQL database
        • Create PaaS MySQL database server
        • Backup MySQL database
        • Backup RDS SQL database to S3
        • Restore RDS SQL database from S3
      • AWS
        • AWS
        • Provision an AWS RDS instance
        • Change AWS load balancer target group
        • Delete an AWS CloudFormation stack
      • Azure
        • Azure
        • Deploy an Azure Resource Manager template
        • Provision an Azure App Service
        • Manage DNS records in Azure
      • GCP
        • GCP
        • Create Network Load Balancer
      • Terraform
        • Terraform
        • Provision AWS resources with Terraform
  • Feature Toggles
  • Tasks
    • Overview
    • Prioritize Tasks
  • Approvals
    • Overview
    • Jira Service Management Integration
    • ServiceNow Integration
  • Insights
    • Overview
    • Metrics
    • Trend indicators
    • Project Insights
    • Space Level Insights
    • CSV download
    • API
  • Octopus REST API
    • Overview
    • Getting started with the Octopus REST API
    • How to Create an API Key
    • Octopus.Client
      • Octopus.Client
      • Getting started
      • Working with Resources
      • Working directly with the Client
      • Working with Spaces
      • Using in an Octopus Step
    • Using OpenID Connect with the Octopus API
      • Using OpenID Connect with the Octopus API
      • Using OpenID Connect with Octopus and GitHub Actions
      • Using OpenID Connect in Octopus with other issuers
    • API examples
      • API examples
      • Accounts
        • Accounts
        • Create an AWS account
        • Create an Azure service principal
        • Create a Google Cloud account
      • Artifacts
        • Artifacts
        • Upload Artifact to Existing Deployment
        • Download Deployment Artifact
        • Download Runbook Artifact
      • Certificates
        • Certificates
        • Create a certificate
        • Replace existing certificate
      • Channels
        • Channels
        • Create a channel
      • Deployment process
        • Deployment process
        • Add an environment to step
        • Add a run a script step
        • Get all steps that use a package
        • Get all steps using role
      • Deployment targets
        • Deployment targets
        • Add an Azure Web App
        • Add a target role
        • Add Tenants to targets
        • Change target's machine policy
        • Check Tentacles for available upgrades
        • Delete targets by name
        • Delete targets by role
        • Deactivate machines
        • Find target usage
        • Find unused targets
        • Register Listening Tentacle
        • Register Polling Tentacle
        • Register SSH target
        • Upgrade targets
      • Deployments
        • Deployments
        • Cancel queued deployments
        • Create and deploy a release
        • Deploy existing release with prompted variables
        • Deploy existing release
        • List deployments to environment
      • Environments
        • Environments
        • Adding Environments
      • Events
        • Events
        • Find events by date
      • Feeds
        • Feeds
        • Change feed
        • Create a feed
        • Delete a feed
        • Download package from built-in feed
        • Push package to built-in feed
        • Retrieve all feeds
        • Synchronize packages
      • Lifecycles
        • Lifecycles
        • Create a lifecycle
      • Project Groups
        • Project Groups
        • Create a project group
      • Projects
        • Projects
        • Coordinating multiple projects
        • Create a project
        • Delete a project
        • Delete projects with no process
        • Disable project triggers
        • Deactivate projects
        • Export projects
        • Find unused projects
        • Import projects
      • Releases
        • Releases
        • Create a release with specific version
        • Delete project releases
        • Promote a release not in the destination
        • Update release variable snapshot
      • Reports
        • Reports
        • Deployments Per Deployment Target Role Report
        • Environment permissions report
        • Project permissions report
        • Project Release Deployment Targets Report
      • Runbooks
        • Runbooks
        • Add a script step to runbook
        • Create and publish a new runbook snapshot
        • Create a runbook
        • Create a new scheduled runbook trigger
        • Publish a runbook snapshot
        • Run a runbook with prompted variables
        • Run a published runbook
      • Spaces
        • Spaces
        • Add a Space with environments
        • Delete a Space
      • Step Templates
        • Step Templates
        • Export step templates
      • Tag sets
        • Tag sets
        • Create a tag set
      • Tasks
        • Tasks
        • Reprioritize Tasks
        • Run a health check
      • Tenants
        • Tenants
        • Create a tenant
        • Deactivate tenants
        • Update tenant variables
      • Users and Teams
        • Users and Teams
        • Add Microsoft Entra ID login to users
        • Add domain teams
        • Add an environment to a team
        • Change users domain
        • Create an API Key
        • Find teams with role
        • List users with editing roles
        • List users with role
        • List users
        • Remove a project from team
        • Swap AD group with LDAP group
        • Change users AD domain to LDAP
      • Variables
        • Variables
        • Add variable set to a project
        • Add or update project variable
        • Clear sensitive variables
        • Find projects using variable set
        • Find variable usage
        • Find variable value usage
        • Find variable set variables usage
        • Update variable set variable value
      • Bulk Operations
        • Bulk Operations
        • Bulk add a project to a list of tenants
        • Rerun all canceled deployments and runbook runs after node shutdown.
    • Octopus.Server.exe command line
      • Octopus.Server.exe command line
      • Admin
      • Check services
      • Configure
      • Create instances
      • Database
      • Delete instances
      • Export certificates
      • Import certificates
      • License
      • List instances
      • Lost Master Key
      • Rotate Master Key
      • Set Master Key
      • Metrics
      • New certificate
      • Node
      • Built-in Worker
      • Path
      • External Worker
      • Proxy
      • Regenerate certificates
      • Run
      • Service
      • Show configuration
      • Show Master Key
      • Show thumbprint
      • SSL certificate
      • Version
      • Watchdog
    • Tentacle.exe command line
      • Tentacle.exe command line
      • Agent
      • Check services
      • Configure
      • Create instance
      • Delete instance
      • Deregister from
      • Deregister Worker
      • Extract
      • Import certificate
      • List instances
      • New certificate
      • Poll server
      • Polling proxy
      • Proxy
      • Register with
      • Register Worker
      • Server comms
      • Service
      • Show configuration
      • Show thumbprint
      • Update trust
      • version
      • watchdog
    • Calamari
    • Octopus.Migrator.exe command line
      • Octopus.Migrator.exe command line
      • Migrator export
      • Migrator import
      • migrate
      • Partial export
      • Version
    • Migration API
    • CLI
      • CLI
      • octopus
      • octopus account
      • octopus account aws
      • octopus account aws create
      • octopus account aws list
      • octopus account azure
      • octopus account azure create
      • octopus account azure list
      • octopus account azure-oidc
      • octopus account azure-oidc create
      • octopus account azure-oidc list
      • octopus account create
      • octopus account delete
      • octopus account gcp
      • octopus account gcp create
      • octopus account gcp list
      • octopus account generic-oidc
      • octopus account generic-oidc create
      • octopus account generic-oidc list
      • octopus account list
      • octopus account ssh
      • octopus account ssh create
      • octopus account ssh list
      • octopus account token
      • octopus account token create
      • octopus account token list
      • octopus account username
      • octopus account username create
      • octopus account username list
      • octopus build-information
      • octopus build-information bulk-delete
      • octopus build-information delete
      • octopus build-information list
      • octopus build-information upload
      • octopus build-information view
      • octopus channel
      • octopus channel create
      • octopus config
      • octopus config get
      • octopus config list
      • octopus config set
      • octopus deployment-target
      • octopus deployment-target azure-web-app
      • octopus deployment-target azure-web-app create
      • octopus deployment-target azure-web-app list
      • octopus deployment-target azure-web-app view
      • octopus deployment-target cloud-region
      • octopus deployment-target cloud-region create
      • octopus deployment-target cloud-region list
      • octopus deployment-target cloud-region view
      • octopus deployment-target delete
      • octopus deployment-target kubernetes
      • octopus deployment-target kubernetes create
      • octopus deployment-target kubernetes list
      • octopus deployment-target kubernetes view
      • octopus deployment-target list
      • octopus deployment-target listening-tentacle
      • octopus deployment-target listening-tentacle create
      • octopus deployment-target listening-tentacle list
      • octopus deployment-target listening-tentacle view
      • octopus deployment-target polling-tentacle
      • octopus deployment-target polling-tentacle list
      • octopus deployment-target polling-tentacle view
      • octopus deployment-target ssh
      • octopus deployment-target ssh create
      • octopus deployment-target ssh list
      • octopus deployment-target ssh view
      • octopus deployment-target view
      • octopus environment
      • octopus environment create
      • octopus environment delete
      • octopus environment list
      • octopus login
      • octopus logout
      • octopus package
      • octopus package delete
      • octopus package list
      • octopus package nuget
      • octopus package nuget create
      • octopus package upload
      • octopus package versions
      • octopus package zip
      • octopus package zip create
      • octopus project
      • octopus project branch
      • octopus project branch create
      • octopus project branch list
      • octopus project clone
      • octopus project connect
      • octopus project convert
      • octopus project create
      • octopus project delete
      • octopus project disable
      • octopus project disconnect
      • octopus project enable
      • octopus project list
      • octopus project variables
      • octopus project variables create
      • octopus project variables delete
      • octopus project variables exclude
      • octopus project variables include
      • octopus project variables list
      • octopus project variables update
      • octopus project variables view
      • octopus project view
      • octopus project-group
      • octopus project-group create
      • octopus project-group delete
      • octopus project-group list
      • octopus project-group view
      • octopus release
      • octopus release create
      • octopus release delete
      • octopus release deploy
      • octopus release list
      • octopus release progression
      • octopus release progression allow
      • octopus release progression prevent
      • octopus runbook
      • octopus runbook delete
      • octopus runbook list
      • octopus runbook run
      • octopus runbook snapshot
      • octopus runbook snapshot create
      • octopus runbook snapshot list
      • octopus runbook snapshot publish
      • octopus space
      • octopus space create
      • octopus space delete
      • octopus space list
      • octopus space view
      • octopus task
      • octopus task wait
      • octopus tenant
      • octopus tenant clone
      • octopus tenant connect
      • octopus tenant create
      • octopus tenant delete
      • octopus tenant disable
      • octopus tenant disconnect
      • octopus tenant enable
      • octopus tenant list
      • octopus tenant tag
      • octopus tenant variables
      • octopus tenant variables list
      • octopus tenant variables update
      • octopus tenant view
      • octopus user
      • octopus user delete
      • octopus user list
      • octopus worker
      • octopus worker delete
      • octopus worker list
      • octopus worker listening-tentacle
      • octopus worker listening-tentacle create
      • octopus worker listening-tentacle list
      • octopus worker listening-tentacle view
      • octopus worker polling-tentacle
      • octopus worker polling-tentacle list
      • octopus worker polling-tentacle view
      • octopus worker ssh
      • octopus worker ssh create
      • octopus worker ssh list
      • octopus worker ssh view
      • octopus worker view
      • octopus worker-pool
      • octopus worker-pool delete
      • octopus worker-pool dynamic
      • octopus worker-pool dynamic create
      • octopus worker-pool dynamic view
      • octopus worker-pool list
      • octopus worker-pool static
      • octopus worker-pool static create
      • octopus worker-pool static view
      • octopus worker-pool view
    • Octo Command Line (CLI) (Deprecated)
      • Octo Command Line (CLI) (Deprecated)
      • Octopus CLI Global Tool
      • JSON formatted output
      • Allow release progression
      • Build information
      • Clean environments
      • Clean Worker pool
      • Complete
      • Create auto deployment override
      • Create channel
      • Create environment
      • Create project
      • Create release
      • Create Worker pool
      • Delete auto deploy override
      • Delete package
      • Delete project
      • Delete releases
      • Deploy release
      • Disable project
      • Dump deployments
      • Export
      • Import
      • Install autocomplete
      • List deployments
      • List environments
      • List latest deployments
      • List machines
      • List projects
      • List releases
      • List tenants
      • List Worker pools
      • List Workers
      • Pack
      • Prevent release progression
      • Promote release
      • Push metadata
      • Push
      • Run a runbook
      • Version
  • Administration
    • Overview
    • High Availability
      • High Availability
      • How High Availability Works
      • Migration
      • Auto Scaling High Availability Nodes
      • Polling Tentacles with HA
      • Troubleshooting
    • Data
      • Octopus database
      • Backup and restore
      • Changing the collation of the Octopus database
      • Data Migration
    • Spaces
    • Upgrading Octopus
      • Upgrading Octopus
      • Upgrading a modern version of Octopus
        • Upgrading a modern version of Octopus
        • Upgrading minor and patch releases of Octopus Deploy
        • Upgrading major releases of Octopus Deploy
        • How to automate Octopus Deploy upgrades
        • Upgrading host OS or .NET
        • Creating a test instance
      • Upgrading old versions of Octopus
        • Upgrading old versions of Octopus
        • Upgrading from Octopus 1.6 to 2.6.5
        • Upgrading from Octopus 2.6.5 to 2018.10 LTS
          • Upgrading from Octopus 2.6.5 to 2018.10 LTS
          • In place upgrade (Install Over 2.6.5)
          • Manual upgrade
          • Upgrade with a new server instance
          • Migrating data from Octopus 2.6.5 to 2018.10 LTS
          • Troubleshooting
          • Minimize the data-migration time
          • Backup v2.6 database
        • Upgrading from Octopus 2.x to 2.6.5
        • Upgrading from Octopus 3.x to the latest version
        • Upgrading from Octopus 4.x / 2018.x to latest version
    • Sync multiple instances
    • Managing infrastructure
      • Managing infrastructure
      • Maintenance Mode
      • Applying Operating System upgrades
      • Recovering after losing your Octopus Server and Master Key
      • Rotating the Master Key
      • Performance
        • Performance
        • Providing database performance metrics
        • Record a performance trace
        • Record memory snapshots
        • Create sanitized database backup
        • Enable web request logging
      • Run multiple processes on a target simultaneously
      • Managing multiple instances
      • Automating infrastructure with DSC
      • Script Console
      • Moving your Octopus components to other servers
        • Moving your Octopus components to other servers
        • Move the Octopus home folder and the Tentacle home and application folders
        • Moving the Octopus Server
        • Moving the Octopus Server database
        • Moving the Octopus Server and database
        • Moving the Octopus home directory
      • Server configuration and file storage
        • Server configuration and file storage
        • Moving Octopus Server folders
        • Manually uninstall Octopus Server
      • Tentacle configuration and file storage
        • Tentacle configuration and file storage
        • Manually uninstall Tentacle
      • Subscriptions
        • Subscriptions
        • Subscription webhook notifications
      • Show configuration
      • Service watchdog
      • Diagnostics
    • Private cloud migration
    • Retention policies
      • Retention policies
      • Retention policy Tentacle cleanup and troubleshooting
    • Reporting
      • Reporting
      • Report on deployments using Excel and XML
      • Report on deployments using SQL
      • Octopus reporting with an Excel template
    • Octopus extension for GitHub Copilot
  • 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
  • Security
    • Overview
    • Script integrity in Octopus Deploy
    • Hardening Octopus
    • Exposing Octopus
      • Exposing Octopus
      • Expose the Octopus Web Portal over HTTPS
      • Let's Encrypt integration
    • Outbound requests
      • Outbound requests
      • Telemetry
    • HTTP Security Headers
    • Octopus - Tentacle communication
      • Octopus - Tentacle communication
      • How to use custom certificates with Octopus Server and Tentacle
      • How to regenerate certificates with Octopus Server and Tentacle
      • Troubleshooting Schannel and TLS
    • Authentication
      • Authentication
      • Authentication provider compatibility
      • Username and Password
      • Active Directory authentication
        • Active Directory authentication
        • Moving your Octopus Server to another Active Directory domain
        • Specify a custom container for AD authentication
        • Troubleshooting Active Directory integration
      • Microsoft Entra ID authentication
      • Google Workspace authentication
      • LDAP Authentication
      • Okta authentication
      • Octopus ID authentication
      • Guest login
      • Automatic user creation
      • Authentication automation with OctopusDSC
      • Troubleshooting authentication problems
    • Data encryption
    • Built-in Worker
    • Users and teams
      • Users and teams
      • Resetting passwords
      • Security and unscoped variables
      • Service accounts
      • External groups and roles
      • Teams with mixed environment privileges
      • Auditing
        • Auditing
        • Audit Stream
      • Default permissions for built-in user roles
      • System and space permissions
      • Configurable Timeouts and Session Invalidation
      • User roles
    • FIPS and Octopus Deploy
    • PCI compliance and Octopus Deploy
    • Common security vulnerabilities and exploits
      • Common security vulnerabilities and exploits
      • Cross-Site Request Forgery (CSRF) and Octopus Deploy
      • SHA1 "Shattered" collision and Octopus Deploy
      • Spectre (Speculative Execution Side-Channel Vulnerabilities), Meltdown, and Octopus Deploy
      • Cross-Site Scripting (XSS) and Octopus Deploy
      • ZipBombs and Octopus Deploy
    • Security Self Assessment Questionnaire (CAIQ - Lite)
  • Support
    • Overview
    • Get the Raw Output From a Task
    • Debug problems with Octopus variables
    • Get the raw output from a deployment process
    • Log files
    • Support screen capture
    • Copy the working directory
    • Troubleshooting AWS transport level errors
    • Troubleshooting failed or hanging tasks
    • Troubleshooting Access Denied Starting Http Listener
    • Capture a crash dump
    • Process dumps
    • Send a secret to Octopus
    • Capture and export a HAR file
    • How to turn on variable logging and export the task log
    • How to get a database backup and encrypt your Master Key
    • Record a problem with Octopus Deploy in your web browser
    • Call the Jenkins REST API from PowerShell
    • Compatibility
    • Increase the Octopus Server task cap
  • Credits
  • GitHub Organizations
  • Deprecations
  • Search
Free trial
  1. Introduction
  2. Page not found

Page not found

We couldn’t find the page you tried to visit, sorry.

You might like to go to the docs home page, try a search, or head to the Octopus home page.

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Monday, February 20, 2023

Edit on GitHub
Next article Introduction

Navigation

  • 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
    • 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
  • 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
  • Kubernetes
    • Overview
    • Targets
      • Overview
      • Kubernetes agent
        • Overview
        • 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
      • Kubernetes Object Status
      • 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
  • 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
        • Troubleshooting 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
  • 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
          • Environment specific .NET configuration transforms with sensitive values
          • Troubleshooting .NET configuration transforms
        • Substitute variables in templates
        • NGINX Web Server
      • Conditions
      • Execution containers for workers
    • Built-in step templates
      • Built-in step templates
      • Email notification step
      • Manual intervention and approval step
      • Health check step
      • Automatic step template updates
    • Exporting and Importing Projects
    • Community step templates
    • Custom step templates
      • Custom step templates
      • Custom step templates stored in Git
    • Updating step templates
    • Variables
      • Variables
      • Getting started with variables
      • Variable substitutions
      • Variable filters
      • System variables
      • Output variables
      • Prompted variables
      • Sensitive variables
      • Certificate variables
      • Worker Pool variables
      • Google Cloud account variables
      • Azure account variables
      • AWS account variables
      • Username and password account variables
      • Tenant variables
      • Variable sets
    • Tenants
      • Overview
      • Bulk connection
    • Project triggers
      • Project triggers
      • Deployment target triggers
      • Scheduled deployment triggers
      • External feed triggers
      • Built-in package repository triggers
      • Git repository triggers
    • Coordinating multiple projects
      • Coordinating multiple projects
      • Project coordination code samples
      • Deploy a release step
    • Configuration as Code
      • Configuration as Code
      • Converting projects to Git
        • Converting projects to Git
        • Migrating variables to Git
      • Configuration as Code reference
      • Editing a project with version control enabled
      • GitHub integration
      • Creating and deploying releases on a version-controlled project
      • Creating releases from a build server plugin on a version-controlled project
      • Unsupported Configuration as Code Scenarios
      • Moving version control
      • OCL Syntax for Config as Code
  • Tenants
    • Overview
    • Tenant types
    • Tenant creation
      • Tenant creation
      • Tenanted deployments
      • Connecting projects
    • Tenant variables
    • Tenant tags
    • Tenant infrastructure
    • Tenant lifecycles
    • Tenant roles and security
    • Multi-tenant deployment guides
      • Multi-tenant deployment guides
      • Multi-tenant regions
      • Multi-tenant SaaS applications
      • Multi-tenant teams
        • Multi-tenant teams
        • Creating new tenants
        • Assigning a team to a tenant
        • Deploying to a team tenant
      • Tenants sharing machine targets
        • Tenants sharing machine targets
        • Creating the tenant tag set
        • Assign tags to tenants
        • Assign tags to targets
        • Deploying before the concurrency tag is changed
        • Setting the Concurrency Tag
        • Deploying after the concurrency tag is changed
        • Summary and FAQ
    • Multi-tenant deployments FAQ
    • Troubleshooting multi-tenant deployments
  • Releases
    • Overview
    • Creating a release
    • Lifecycles
    • Channels
    • Guided failures
    • Prevent release progression
    • Deleting releases
    • Manually fail a task
    • Issue trackers
      • Issue trackers
      • Jira issue tracking
      • GitHub issue tracking integration
      • Azure DevOps work item tracking integration
    • Release versioning
    • Deployment changes
    • Deployment Timeline
    • Release notes
  • Deployments
    • Overview
    • AWS
      • AWS
      • Amazon S3 Create Bucket
      • Deploy an AWS CloudFormation template
      • Update Amazon ECS Service
      • Deploy Amazon ECS Service
      • AWS permissions required by Octopus
      • Delete an existing AWS CloudFormation stack
      • Upload to AWS S3 template
    • Google Cloud
      • Google Cloud
      • Google cloud CLI scripts
    • Azure
      • Azure
      • Azure Service Fabric
        • Azure Service Fabric
        • Packaging a Service Fabric application
        • Deploying a package to an Azure Service Fabric cluster
        • Version automation with Service Fabric application packages
        • Connecting securely with client certificates
        • Connecting securely with Azure Active Directory
      • Varying Azure subscription by environment
      • Azure environments
      • Azure app service environments
      • Deploying to Azure via a firewall
      • Azure web apps
        • Azure web apps
        • Deploying Web Jobs
        • Using Deployment Slots with Azure Web Apps
      • Running Azure PowerShell
        • Running Azure PowerShell
        • Configuring the version of the Azure CLI
        • Configuring the version of the Azure PowerShell Modules
    • .NET deployments
      • .NET deployments
      • ASP.NET Core webapp
    • Docker Containers
      • Docker Containers
      • Accessing container details
      • Docker run with networking
    • Windows
      • Windows
      • Windows Services
      • IIS Websites and application pools
      • Virtual hard drives
    • Certificates
      • Certificates
      • Add a certificate to Octopus
      • Certificate chains
      • Import certificate to Windows certificate store
      • Import certificates into Tomcat
      • Import certificates into WildFly and JBoss EAP
      • Export a certificate
      • Export a certificate to a Java KeyStore
      • Replace a certificate
      • Archive and delete certificates
      • Troubleshooting invalid certificates
    • Databases
      • Databases
      • Database configuration
        • Database configuration
        • Install Tentacles and Workers for database deployments
        • Recommended database permissions
      • SQL Server deployments
        • SQL Server deployments
        • SQL Server permissions
        • SQL Server DACPAC deployment
        • Deploy to SQL Server using Redgate SQL change automation
      • Common patterns
        • Common patterns
        • Manual approvals
        • Automatic approvals
        • Ad-hoc data change scripts
        • Database backups and rollbacks
      • MySQL flyway deployment
    • Terraform
      • Terraform
      • Preparing your Terraform environment
      • Terraform step configuration
      • Planning changes made by Terraform templates
      • Applying changes from Terraform templates
      • Terraform output variables
      • Terraform plugin cache
    • Java applications
      • Java applications
      • Deploying a sample Java application
      • Java error messages and troubleshooting
    • NGINX deployments
      • NGINX deployments
      • Configuring target machine
      • Create and push an ASP.NET Core project
      • Configure Octopus Deploy project
    • Node deployments
      • Node deployments
      • Deploying Node applications to Linux
    • Packages
      • Packages
      • Dynamically selecting packages at deployment time
      • Delta compression for package transfers
      • Stage package uploads
      • Package deployment feature ordering
      • Deploying packages to your Octopus Server
      • Transfer package
      • Troubleshoot missing packages
    • Custom scripts
      • Custom scripts
      • Run a script step
      • Scripts in packages
        • Scripts in packages
        • Reference files within a package
      • Using variables in scripts
      • Passing parameters to scripts
      • Logging messages from scripts
      • Error handling
      • Output variables
      • Raw scripting
      • Azure CLI and PowerShell Scripts
      • AWS CLI and PowerShell scripts
      • Service Fabric PowerShell scripts
      • PowerShell Core
      • Debugging PowerShell scripts
        • Debugging PowerShell scripts
        • Debugging PowerShell scripts on remote machines
      • Script modules
    • HTML and JavaScript applications
    • Bulk deployment creation
    • Deployment freezes
      • Deployment freezes
      • Project deployment freezes
    • Patterns and practices
      • Patterns and practices
      • Rolling deployments
      • Blue-green deployments in Octopus using Environments
        • Blue-green deployments in Octopus using Environments
        • Blue-green deployments in IIS
      • Rollbacks
        • Rollbacks
        • Rollback .NET Application on Windows Server
        • Rolling back a Tomcat deployment
        • Rolling back an NGINX deployment
      • Multi-region deployment pattern
      • Elastic and transient environments
        • Elastic and transient environments
        • Deploying to Transient Targets
        • Keeping deployment targets up to date
        • Cleaning up Environments
        • Immutable Infrastructure
      • Canary deployments
      • Branching
      • Deployment process as code
  • Runbooks
    • Overview
    • Runbooks vs Deployments
    • Config as Code runbooks
    • Runbooks permissions
    • Runbook variables
    • Runbooks publishing
    • Scheduled runbook triggers
    • Runbooks examples
      • Runbooks examples
      • Routine operations
        • Routine operations
        • IIS Runbooks
        • Install software with Chocolatey
        • Updating Windows
        • Updating Linux
        • Hardening Windows
        • Hardening an Ubuntu server
        • Installing Apache
        • Hardening Apache runbook
        • Install NGINX
        • Installing Tomcat on Ubuntu
        • Restarting a Tomcat Web application
        • Renew Let's Encrypt certificates
        • Services Runbooks
      • Emergency operations
        • Emergency operations
        • Manually failover DNS
        • Automatically failover DNS with monitoring
        • Restart server
      • Database examples
        • Database examples
        • Backup SQL database
        • Restore SQL database
        • Restore SQL database to another environment
        • Create MySQL database
        • Create PaaS MySQL database server
        • Backup MySQL database
        • Backup RDS SQL database to S3
        • Restore RDS SQL database from S3
      • AWS
        • AWS
        • Provision an AWS RDS instance
        • Change AWS load balancer target group
        • Delete an AWS CloudFormation stack
      • Azure
        • Azure
        • Deploy an Azure Resource Manager template
        • Provision an Azure App Service
        • Manage DNS records in Azure
      • GCP
        • GCP
        • Create Network Load Balancer
      • Terraform
        • Terraform
        • Provision AWS resources with Terraform
  • Feature Toggles
  • Tasks
    • Overview
    • Prioritize Tasks
  • Approvals
    • Overview
    • Jira Service Management Integration
    • ServiceNow Integration
  • Insights
    • Overview
    • Metrics
    • Trend indicators
    • Project Insights
    • Space Level Insights
    • CSV download
    • API
  • Octopus REST API
    • Overview
    • Getting started with the Octopus REST API
    • How to Create an API Key
    • Octopus.Client
      • Octopus.Client
      • Getting started
      • Working with Resources
      • Working directly with the Client
      • Working with Spaces
      • Using in an Octopus Step
    • Using OpenID Connect with the Octopus API
      • Using OpenID Connect with the Octopus API
      • Using OpenID Connect with Octopus and GitHub Actions
      • Using OpenID Connect in Octopus with other issuers
    • API examples
      • API examples
      • Accounts
        • Accounts
        • Create an AWS account
        • Create an Azure service principal
        • Create a Google Cloud account
      • Artifacts
        • Artifacts
        • Upload Artifact to Existing Deployment
        • Download Deployment Artifact
        • Download Runbook Artifact
      • Certificates
        • Certificates
        • Create a certificate
        • Replace existing certificate
      • Channels
        • Channels
        • Create a channel
      • Deployment process
        • Deployment process
        • Add an environment to step
        • Add a run a script step
        • Get all steps that use a package
        • Get all steps using role
      • Deployment targets
        • Deployment targets
        • Add an Azure Web App
        • Add a target role
        • Add Tenants to targets
        • Change target's machine policy
        • Check Tentacles for available upgrades
        • Delete targets by name
        • Delete targets by role
        • Deactivate machines
        • Find target usage
        • Find unused targets
        • Register Listening Tentacle
        • Register Polling Tentacle
        • Register SSH target
        • Upgrade targets
      • Deployments
        • Deployments
        • Cancel queued deployments
        • Create and deploy a release
        • Deploy existing release with prompted variables
        • Deploy existing release
        • List deployments to environment
      • Environments
        • Environments
        • Adding Environments
      • Events
        • Events
        • Find events by date
      • Feeds
        • Feeds
        • Change feed
        • Create a feed
        • Delete a feed
        • Download package from built-in feed
        • Push package to built-in feed
        • Retrieve all feeds
        • Synchronize packages
      • Lifecycles
        • Lifecycles
        • Create a lifecycle
      • Project Groups
        • Project Groups
        • Create a project group
      • Projects
        • Projects
        • Coordinating multiple projects
        • Create a project
        • Delete a project
        • Delete projects with no process
        • Disable project triggers
        • Deactivate projects
        • Export projects
        • Find unused projects
        • Import projects
      • Releases
        • Releases
        • Create a release with specific version
        • Delete project releases
        • Promote a release not in the destination
        • Update release variable snapshot
      • Reports
        • Reports
        • Deployments Per Deployment Target Role Report
        • Environment permissions report
        • Project permissions report
        • Project Release Deployment Targets Report
      • Runbooks
        • Runbooks
        • Add a script step to runbook
        • Create and publish a new runbook snapshot
        • Create a runbook
        • Create a new scheduled runbook trigger
        • Publish a runbook snapshot
        • Run a runbook with prompted variables
        • Run a published runbook
      • Spaces
        • Spaces
        • Add a Space with environments
        • Delete a Space
      • Step Templates
        • Step Templates
        • Export step templates
      • Tag sets
        • Tag sets
        • Create a tag set
      • Tasks
        • Tasks
        • Reprioritize Tasks
        • Run a health check
      • Tenants
        • Tenants
        • Create a tenant
        • Deactivate tenants
        • Update tenant variables
      • Users and Teams
        • Users and Teams
        • Add Microsoft Entra ID login to users
        • Add domain teams
        • Add an environment to a team
        • Change users domain
        • Create an API Key
        • Find teams with role
        • List users with editing roles
        • List users with role
        • List users
        • Remove a project from team
        • Swap AD group with LDAP group
        • Change users AD domain to LDAP
      • Variables
        • Variables
        • Add variable set to a project
        • Add or update project variable
        • Clear sensitive variables
        • Find projects using variable set
        • Find variable usage
        • Find variable value usage
        • Find variable set variables usage
        • Update variable set variable value
      • Bulk Operations
        • Bulk Operations
        • Bulk add a project to a list of tenants
        • Rerun all canceled deployments and runbook runs after node shutdown.
    • Octopus.Server.exe command line
      • Octopus.Server.exe command line
      • Admin
      • Check services
      • Configure
      • Create instances
      • Database
      • Delete instances
      • Export certificates
      • Import certificates
      • License
      • List instances
      • Lost Master Key
      • Rotate Master Key
      • Set Master Key
      • Metrics
      • New certificate
      • Node
      • Built-in Worker
      • Path
      • External Worker
      • Proxy
      • Regenerate certificates
      • Run
      • Service
      • Show configuration
      • Show Master Key
      • Show thumbprint
      • SSL certificate
      • Version
      • Watchdog
    • Tentacle.exe command line
      • Tentacle.exe command line
      • Agent
      • Check services
      • Configure
      • Create instance
      • Delete instance
      • Deregister from
      • Deregister Worker
      • Extract
      • Import certificate
      • List instances
      • New certificate
      • Poll server
      • Polling proxy
      • Proxy
      • Register with
      • Register Worker
      • Server comms
      • Service
      • Show configuration
      • Show thumbprint
      • Update trust
      • version
      • watchdog
    • Calamari
    • Octopus.Migrator.exe command line
      • Octopus.Migrator.exe command line
      • Migrator export
      • Migrator import
      • migrate
      • Partial export
      • Version
    • Migration API
    • CLI
      • CLI
      • octopus
      • octopus account
      • octopus account aws
      • octopus account aws create
      • octopus account aws list
      • octopus account azure
      • octopus account azure create
      • octopus account azure list
      • octopus account azure-oidc
      • octopus account azure-oidc create
      • octopus account azure-oidc list
      • octopus account create
      • octopus account delete
      • octopus account gcp
      • octopus account gcp create
      • octopus account gcp list
      • octopus account generic-oidc
      • octopus account generic-oidc create
      • octopus account generic-oidc list
      • octopus account list
      • octopus account ssh
      • octopus account ssh create
      • octopus account ssh list
      • octopus account token
      • octopus account token create
      • octopus account token list
      • octopus account username
      • octopus account username create
      • octopus account username list
      • octopus build-information
      • octopus build-information bulk-delete
      • octopus build-information delete
      • octopus build-information list
      • octopus build-information upload
      • octopus build-information view
      • octopus channel
      • octopus channel create
      • octopus config
      • octopus config get
      • octopus config list
      • octopus config set
      • octopus deployment-target
      • octopus deployment-target azure-web-app
      • octopus deployment-target azure-web-app create
      • octopus deployment-target azure-web-app list
      • octopus deployment-target azure-web-app view
      • octopus deployment-target cloud-region
      • octopus deployment-target cloud-region create
      • octopus deployment-target cloud-region list
      • octopus deployment-target cloud-region view
      • octopus deployment-target delete
      • octopus deployment-target kubernetes
      • octopus deployment-target kubernetes create
      • octopus deployment-target kubernetes list
      • octopus deployment-target kubernetes view
      • octopus deployment-target list
      • octopus deployment-target listening-tentacle
      • octopus deployment-target listening-tentacle create
      • octopus deployment-target listening-tentacle list
      • octopus deployment-target listening-tentacle view
      • octopus deployment-target polling-tentacle
      • octopus deployment-target polling-tentacle list
      • octopus deployment-target polling-tentacle view
      • octopus deployment-target ssh
      • octopus deployment-target ssh create
      • octopus deployment-target ssh list
      • octopus deployment-target ssh view
      • octopus deployment-target view
      • octopus environment
      • octopus environment create
      • octopus environment delete
      • octopus environment list
      • octopus login
      • octopus logout
      • octopus package
      • octopus package delete
      • octopus package list
      • octopus package nuget
      • octopus package nuget create
      • octopus package upload
      • octopus package versions
      • octopus package zip
      • octopus package zip create
      • octopus project
      • octopus project branch
      • octopus project branch create
      • octopus project branch list
      • octopus project clone
      • octopus project connect
      • octopus project convert
      • octopus project create
      • octopus project delete
      • octopus project disable
      • octopus project disconnect
      • octopus project enable
      • octopus project list
      • octopus project variables
      • octopus project variables create
      • octopus project variables delete
      • octopus project variables exclude
      • octopus project variables include
      • octopus project variables list
      • octopus project variables update
      • octopus project variables view
      • octopus project view
      • octopus project-group
      • octopus project-group create
      • octopus project-group delete
      • octopus project-group list
      • octopus project-group view
      • octopus release
      • octopus release create
      • octopus release delete
      • octopus release deploy
      • octopus release list
      • octopus release progression
      • octopus release progression allow
      • octopus release progression prevent
      • octopus runbook
      • octopus runbook delete
      • octopus runbook list
      • octopus runbook run
      • octopus runbook snapshot
      • octopus runbook snapshot create
      • octopus runbook snapshot list
      • octopus runbook snapshot publish
      • octopus space
      • octopus space create
      • octopus space delete
      • octopus space list
      • octopus space view
      • octopus task
      • octopus task wait
      • octopus tenant
      • octopus tenant clone
      • octopus tenant connect
      • octopus tenant create
      • octopus tenant delete
      • octopus tenant disable
      • octopus tenant disconnect
      • octopus tenant enable
      • octopus tenant list
      • octopus tenant tag
      • octopus tenant variables
      • octopus tenant variables list
      • octopus tenant variables update
      • octopus tenant view
      • octopus user
      • octopus user delete
      • octopus user list
      • octopus worker
      • octopus worker delete
      • octopus worker list
      • octopus worker listening-tentacle
      • octopus worker listening-tentacle create
      • octopus worker listening-tentacle list
      • octopus worker listening-tentacle view
      • octopus worker polling-tentacle
      • octopus worker polling-tentacle list
      • octopus worker polling-tentacle view
      • octopus worker ssh
      • octopus worker ssh create
      • octopus worker ssh list
      • octopus worker ssh view
      • octopus worker view
      • octopus worker-pool
      • octopus worker-pool delete
      • octopus worker-pool dynamic
      • octopus worker-pool dynamic create
      • octopus worker-pool dynamic view
      • octopus worker-pool list
      • octopus worker-pool static
      • octopus worker-pool static create
      • octopus worker-pool static view
      • octopus worker-pool view
    • Octo Command Line (CLI) (Deprecated)
      • Octo Command Line (CLI) (Deprecated)
      • Octopus CLI Global Tool
      • JSON formatted output
      • Allow release progression
      • Build information
      • Clean environments
      • Clean Worker pool
      • Complete
      • Create auto deployment override
      • Create channel
      • Create environment
      • Create project
      • Create release
      • Create Worker pool
      • Delete auto deploy override
      • Delete package
      • Delete project
      • Delete releases
      • Deploy release
      • Disable project
      • Dump deployments
      • Export
      • Import
      • Install autocomplete
      • List deployments
      • List environments
      • List latest deployments
      • List machines
      • List projects
      • List releases
      • List tenants
      • List Worker pools
      • List Workers
      • Pack
      • Prevent release progression
      • Promote release
      • Push metadata
      • Push
      • Run a runbook
      • Version
  • Administration
    • Overview
    • High Availability
      • High Availability
      • How High Availability Works
      • Migration
      • Auto Scaling High Availability Nodes
      • Polling Tentacles with HA
      • Troubleshooting
    • Data
      • Octopus database
      • Backup and restore
      • Changing the collation of the Octopus database
      • Data Migration
    • Spaces
    • Upgrading Octopus
      • Upgrading Octopus
      • Upgrading a modern version of Octopus
        • Upgrading a modern version of Octopus
        • Upgrading minor and patch releases of Octopus Deploy
        • Upgrading major releases of Octopus Deploy
        • How to automate Octopus Deploy upgrades
        • Upgrading host OS or .NET
        • Creating a test instance
      • Upgrading old versions of Octopus
        • Upgrading old versions of Octopus
        • Upgrading from Octopus 1.6 to 2.6.5
        • Upgrading from Octopus 2.6.5 to 2018.10 LTS
          • Upgrading from Octopus 2.6.5 to 2018.10 LTS
          • In place upgrade (Install Over 2.6.5)
          • Manual upgrade
          • Upgrade with a new server instance
          • Migrating data from Octopus 2.6.5 to 2018.10 LTS
          • Troubleshooting
          • Minimize the data-migration time
          • Backup v2.6 database
        • Upgrading from Octopus 2.x to 2.6.5
        • Upgrading from Octopus 3.x to the latest version
        • Upgrading from Octopus 4.x / 2018.x to latest version
    • Sync multiple instances
    • Managing infrastructure
      • Managing infrastructure
      • Maintenance Mode
      • Applying Operating System upgrades
      • Recovering after losing your Octopus Server and Master Key
      • Rotating the Master Key
      • Performance
        • Performance
        • Providing database performance metrics
        • Record a performance trace
        • Record memory snapshots
        • Create sanitized database backup
        • Enable web request logging
      • Run multiple processes on a target simultaneously
      • Managing multiple instances
      • Automating infrastructure with DSC
      • Script Console
      • Moving your Octopus components to other servers
        • Moving your Octopus components to other servers
        • Move the Octopus home folder and the Tentacle home and application folders
        • Moving the Octopus Server
        • Moving the Octopus Server database
        • Moving the Octopus Server and database
        • Moving the Octopus home directory
      • Server configuration and file storage
        • Server configuration and file storage
        • Moving Octopus Server folders
        • Manually uninstall Octopus Server
      • Tentacle configuration and file storage
        • Tentacle configuration and file storage
        • Manually uninstall Tentacle
      • Subscriptions
        • Subscriptions
        • Subscription webhook notifications
      • Show configuration
      • Service watchdog
      • Diagnostics
    • Private cloud migration
    • Retention policies
      • Retention policies
      • Retention policy Tentacle cleanup and troubleshooting
    • Reporting
      • Reporting
      • Report on deployments using Excel and XML
      • Report on deployments using SQL
      • Octopus reporting with an Excel template
    • Octopus extension for GitHub Copilot
  • 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
  • Security
    • Overview
    • Script integrity in Octopus Deploy
    • Hardening Octopus
    • Exposing Octopus
      • Exposing Octopus
      • Expose the Octopus Web Portal over HTTPS
      • Let's Encrypt integration
    • Outbound requests
      • Outbound requests
      • Telemetry
    • HTTP Security Headers
    • Octopus - Tentacle communication
      • Octopus - Tentacle communication
      • How to use custom certificates with Octopus Server and Tentacle
      • How to regenerate certificates with Octopus Server and Tentacle
      • Troubleshooting Schannel and TLS
    • Authentication
      • Authentication
      • Authentication provider compatibility
      • Username and Password
      • Active Directory authentication
        • Active Directory authentication
        • Moving your Octopus Server to another Active Directory domain
        • Specify a custom container for AD authentication
        • Troubleshooting Active Directory integration
      • Microsoft Entra ID authentication
      • Google Workspace authentication
      • LDAP Authentication
      • Okta authentication
      • Octopus ID authentication
      • Guest login
      • Automatic user creation
      • Authentication automation with OctopusDSC
      • Troubleshooting authentication problems
    • Data encryption
    • Built-in Worker
    • Users and teams
      • Users and teams
      • Resetting passwords
      • Security and unscoped variables
      • Service accounts
      • External groups and roles
      • Teams with mixed environment privileges
      • Auditing
        • Auditing
        • Audit Stream
      • Default permissions for built-in user roles
      • System and space permissions
      • Configurable Timeouts and Session Invalidation
      • User roles
    • FIPS and Octopus Deploy
    • PCI compliance and Octopus Deploy
    • Common security vulnerabilities and exploits
      • Common security vulnerabilities and exploits
      • Cross-Site Request Forgery (CSRF) and Octopus Deploy
      • SHA1 "Shattered" collision and Octopus Deploy
      • Spectre (Speculative Execution Side-Channel Vulnerabilities), Meltdown, and Octopus Deploy
      • Cross-Site Scripting (XSS) and Octopus Deploy
      • ZipBombs and Octopus Deploy
    • Security Self Assessment Questionnaire (CAIQ - Lite)
  • Support
    • Overview
    • Get the Raw Output From a Task
    • Debug problems with Octopus variables
    • Get the raw output from a deployment process
    • Log files
    • Support screen capture
    • Copy the working directory
    • Troubleshooting AWS transport level errors
    • Troubleshooting failed or hanging tasks
    • Troubleshooting Access Denied Starting Http Listener
    • Capture a crash dump
    • Process dumps
    • Send a secret to Octopus
    • Capture and export a HAR file
    • How to turn on variable logging and export the task log
    • How to get a database backup and encrypt your Master Key
    • Record a problem with Octopus Deploy in your web browser
    • Call the Jenkins REST API from PowerShell
    • Compatibility
    • Increase the Octopus Server task cap
  • Credits
  • GitHub Organizations
  • Deprecations
  • Search

Product

  • Features
  • Tenanted deployments
  • Container deployments
  • What's new
  • Roadmap
  • Octopus vs. Azure DevOps
  • Octopus vs. Jenkins

Learn

  • Getting started
  • Guides
  • DevOps handbook
  • Deployments
  • Runbooks
  • Training videos

Help

  • Contact
  • Help and support
  • Community
  • Discussion forum
  • Upgrade and renew

About us

  • Company
  • Partners
  • Careers
  • Trust center
  • Security
  • Webinars and events
  • Stickers and swag
  • Twitter
  • LinkedIn
  • GitHub
  • YouTube

Copyright © 2025 Octopus Deploy

Back to top