Public Repository

Last pushed: 4 days ago
Short Description
Octopus Deploy Server -
Full Description

This image can be used to bring up an instance of Octopus in a container.

Docker on windows is still relatively new, and should be used with caution.


Docker containers are supported on from Windows Server 2016 and Windows 10.

Make sure you've enabled the containers feature:

Enable-WindowsOptionalFeature -Online -FeatureName containers –All

If you want to run with Hyper-V isolation, enable Hyper-V as well:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V –All

You will also need Docker for Windows installed.


From your windows machine run:

docker run --name OctopusDeploy ^
           --publish 81:81 ^
           --env sqlDbConnectionString="..." ^
           --volume c:/work/octopus-data:c:/Octopus ^

Once it's ready, Octopus will be available on port 81 on a randomly assigned IP Address. You can find the IP address and open the Octopus portal by running:

$docker = docker inspect OctopusDeploy | convertfrom-json
start "http://$($docker[0].NetworkSettings.Networks.nat.IpAddress):81"

A note on MasterKeys

Octopus makes use of MasterKeys for security and encryption. When the container is first run, it will generate a new MasterKey and store it on the data volume supplied. It uses this key to talk to the database, so if you want to keep the data in the database, please do not lose this key.

If you want to use an existing database, you can pass it into docker run as an environment variable --env MasterKey=XXX.


Please contact Octopus Support for support.

Additional Information

  • The default admin credentials are admin / Passw0rd123. This can (and should) be overridden by passing --OctopusAdminUsername=XXX --OctopusAdminPassword=YYY.

  • These images are based off the Octopus-Docker repo on GitHub.

Docker Pull Command