Listening Tentacles

Last updated

When installing a Tentacle, you will be asked to choose how Tentacle will communicate with the Octopus server. In listening mode, Tentacle listens on a TCP port (port 10933 by default). When a package needs to be deployed, Octopus will connect to the Tentacle service on that port. In listening mode Tentacle is the TCP server, and Octopus is the TCP client.

Listening Mode is Recommended
When choosing a communication mode, we recommend listening mode when possible. Listening mode uses the least resources (listening on a TCP port is cheaper than actively trying to connect to one). It also gives you the most control (you can use rules in your firewall to limit which IP addresses can connect to the port). Octopus and Tentacle use SSL when communicating, and Tentacle will outright reject connections that aren't from an Octopus server that it trusts (identified by an X.509 certificate public key that you provide during setup).

SSL Offloading is Not Supported
The communication protocol used by Octopus and Tentacle requires intact end-to-end TLS connection for message encryption, tamper-proofing, and authentication. For this reason SSL offloading is not supported.

Proxy Servers Supported for Tentacle Communications Since Octopus 3.4
The communication protocol used by Octopus and Tentacle 3.4 and above supports proxies. Read more about configuring proxy servers for Tentacle communications in proxy support.

If you are using a version of Octopus/Tentacle prior to 3.4 you will need to arrange a bypass/exception for traffic initiated from the Octopus server to the Tentacle on the configured TCP Port (port 10933 by default).


Download the Tentacle MSI
The latest Tentacle MSI can always be downloaded from the Octopus Deploy downloads page.

This four minute video (with captions) will walk you through the process of installing a Tentacle in listening mode, and registering it with your Octopus Deploy server.

Firewall Changes

To allow your Octopus Deploy server to connect to the Tentacle, you'll need to allow access to TCP port 10933 on the Tentacle (or the port you selected during the installation wizard - port 10933 is just the default).

Using listening mode, you won't typically need to make any firewall changes on the Octopus Deploy server.

Intermediary Firewalls
Don't forget to allow access not just in Windows Firewall, but also any intermediary firewalls between the Octopus server and your Tentacle. For example, if your Tentacle server is hosted in Amazon EC2, you'll also need to modify the AWS security group firewall to tell EC2 to allow the traffic. Similarly if your Tentacle server is hosted in Microsoft Azure you'll also need to add an Endpoint to tell Azure to allow the traffic.

In This Section

The following topics are explained further in this section: