Docs
Free trial

Username and password accounts

A username/password account can be used to connect SSH deployment targets and services like Google Cloud Platform if you are using the Kubernetes functionality in Octopus.

Enabling username and password authentication on Linux

Depending on your SSH target machine’s distribution you may need to enable password authentication.

To allow the Octopus Server to connect using the provided credentials you the will need to modify the sshd_config file on the target machine:

  1. Open the /etc/ssh/sshd_config file.
  2. Find the line that contains: PasswordAuthentication and change it to: PasswordAuthentication yes.
  3. Restart the SSH service under root privileges: service ssh restart.

If you experience problems connecting, it may help to try connecting directly to the target machine using these credentials though a client like putty. This will help eliminate any network related problems with your Octopus configuration.

Different distributions use different conventions While the above instructions should work on common platforms like Ubuntu or Red Hat, you may need to double check the details for specific instructions relating to SSH authentication on target operating system. There are many different Linux based distributions, and some of these have their own unique way of doing things. For this reason we cannot guarantee that these SSH instructions will work in every case.

Create a username and password account

  1. Navigate to Infrastructure ➜ Accounts and click ADD ACCOUNT.
  2. Select Username/Password from the drop-down menu.
  3. Give the account a name, for instance, SSH backup server or Google.
  4. Add a description.
  5. Add the username and password you use to authenticate against the remote host.
  6. If you want to restrict which environments can use the account, select only the environments that are allowed to account. If you don’t select any environments, all environments will be allowed to use the account.
  7. Click SAVE.

The account is now ready to be used when you configure your SSH deployment target.

Help us continuously improve

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

Send feedback

Page updated on Wednesday, October 4, 2023

Edit on GitHub