This section walks you through installing the central Octopus Deploy server.
Once installed, the Octopus Deploy server:
- Runs as a Windows Service.
- Stores its data in an SQL Server database.
- Has an embedded HTTP server which serves the Octopus REST API and the Octopus Web Portal that you will use to manage your deployments.
You need to download the latest version of the Octopus Installer.
- Start the Octopus Installer and follow the onscreen prompts.
Accept the License Agreement, and either accept the default Destination Folder or choose a different location.
- Click Install, and give the app permission to make changes to your device.
- Click finish to exit the installation wizard and launch the Getting started wizard to configure your Octopus Deploy server.
- Click Get Started and either enter your details to start a free trial of Octopus or enter your license key.
- Accept the default Home Directory or enter a location of your choice.
- Decide whether to use a Local System Account or a Custom Domain Account.
Learn more about the permissions required for the Octopus Windows Service, using a Managed Service Account, or configuring authentication providers.
- On the Database page, click the dropdown arrow in the Server Name field to detect the SQL Server Database.
- Enter a name for the database, and click OK to create the database.
Be careful not to use the name of an existing database as the setup process will install Octopus into that pre-existing database.
- Accept the default port and directory or enter your own.
- If you’re using username and passwords stored in Octopus authentication mode, enter the username and password that will be used for the Octopus Administrator. If you are using active directory, enter the active directory user details.
- Click Install.
When the installation has completed, click Finish to launch the Octopus Manager.
You can launch the Octopus Web Portal from the Octopus Manager, by clicking Open in Browser.
Before you do, it's worth taking note of the other settings such as controlling the Octopus Windows Service.
Save the Master Key
Under the storage section, you will see a link to View Master Key. The Master Key
When Octopus is installed, it generates a master key which is a random string that is used to encrypt sensitive data in your Octopus database. You will need to the master key if you ever need to restore an Octopus backup.
Take a copy of the master key and save it in a secure location.
Launch the Octopus Web Portal
Click Open in browser to launch the Octopus Web Portal and log in using the authentication details you set up during the configuration process.
If you've had any problems with the installation, review the troubleshooting page.
Now that you've installed the Octopus Deploy server, it's time to configure your Infrastructure.
In This Section
The rest of this section covers these topics in some more detail, and explains how to implement them.