This page describes the steps and considerations to move your Octopus Server from one Active Directory domain to another.
We assume your Octopus Server and users are currently in the same domain -
Domain A. It’s also assumed that your users will remain in
- Update your infrastructure to move the server from one domain (
Domain A) to another (
- Ensure that
Domain A. This can be either one way trust where
Domain Aor two-way trust where
Domain B. This is largely a decision you and your infrastructure personnel need to decide.
- Update your Octopus Server windows service account if desired.
If needed, you can update the account the Octopus Server windows service is running under. If you select an account from
Domain B then you need to ensure that there is a two-way trust relationship in place. If you do change the account, then you need to ensure that your Octopus Sql Server database grants this user access to the database as a
Assuming your users’ email address, SAMAccountName or UPN do not change, then they should now be able to login normally.
If you move your users to the new domain as well, this should still work assuming that the user’s email address, SAM or UPN do not change. If they do, then you’ll need to update your instance to migrate your users/teams over.
Take care when moving Octopus to a new domain if you have mapped external groups and roles to Teams in Octopus. Octopus stores the Active Directory security group SIDs, however, it does not store the Active Directory security group names. You need to ensure the new domain uses the same SIDs so that the groups and the users that belong to the groups will be recognized. Even if you use the same group names, Octopus will not recognize the group unless the SIDs are the same.
If you need to edit your groups, this can get complicated. Read our page on external groups and roles for more information.
Help us continuously improve
Please let us know if you have any feedback about this page.
Last updated Sunday, January 1, 2023