Octopus Deploy Documentation

Deployment Targets

Last updated

Deployment targets are the servers and services that host your deployed software. You can manage your deployment targets by navigating to Infrastructure ➜ Deployment Targets in the Octopus Web Portal.

From the Deployment Targets tab you can add new deployment targets, disable or delete deployment targets, check on the status of your targets, and run health checks.

Adding Deployment Targets

Deployment targets are added in different ways, depending on the type of target you are adding and how the target will communicate with the Octopus Deploy server. For instructions, see:


In addition to the deployment targets above, you may also need to configure accounts to use in conjunction with your infrastructure during your deployments.

You can configure the following accounts:

Target Roles

Before you can deploy software to the deployment targets in your environments, you need to tag your deployment targets with target roles. This ensures you deploy the right pieces of software to the right deployment targets. Deployment targets can have multiple roles, but they must have at least one. Typical target roles include:

  • web-server
  • app-server
  • db-server

Using target roles means the infrastructure in each of your environments doesn't need to be identical. For instance, in the Test environment, you might be using a single VM to test all of your software, and so you tag that VM with all of the target roles you use in your deployment process. However, in the Production environment you might have one or more dedicated deployment targets per functional role, for instance, one deployment target for the database server which you would tag with the target role db-server, and another deployment target that performs the role of web server and is tagged with the target role web-server.

Deployment targets can have more than one role, and more than one deployment target can have the same role.

As you decide on the target roles for your infrastructure, try to name the target roles based on the function the deployment targets will serve rather than describing some attribute of the deployment targets.

Creating Target Roles

Roles are created and saved in the database as soon as you assign them to a deployment target.

Decide on the naming convention you will use before creating your first target role as it's not possible to change the case after the role has been created, for instance, all lowercase to camel case.

  1. Register a deployment target or click on an already registered deployment target and go to Settings.
  2. In the Target Roles field, enter the target role you'd like to use (no spaces).
  3. Save the target settings.

The role has been created and assigned to the deployment target and can be added to other deployment targets.

You can check all the roles assigned to your deployment targets from the Infrastructure tab.

Dynamic Infrastructure

You can use scripts to create Azure Service Principal Accounts, Azure Web Apps, Azure Service Fabric, Azure Cloud Services and Kubernetes targets.

Learn about Managing resources with scripts.

See Also

Welcome! We use cookies and data about how you use our website allow us to improve the website and your experience, and resolve technical errors. Our website uses cookies and shares some of your data with third party analytics companies for these purposes. We do not use these cookies for advertising.

If you decline, we will respect your privacy. A single cookie will be used in your browser to remember your preference.