Occasionally it may be necessary to change the location at which Tentacle stores its configuration and data, called the Tentacle Home Directory. By default your applications will be deployed into a folder under the Tentacle Home Directory, but you can configure this to be at a different location. This page will explain what each of the folders used by Tentacle are, how you can change the Tentacle configuration, and how you can clean up after upgrading from an earlier version of Tentacle.
Make sure you have a current backup of your Tentacle Home Directory before proceeding.
If you need to re-configure your Tentacle instance, you can do that using the command-line as described below.
Tentacle configure [<options>]
[<options>]is any of:
--instance=VALUE Name of the instance to use --home, --homedir=VALUE Home directory --app, --appdir=VALUE Default directory to deploy applications to --port=VALUE TCP port on which Tentacle should listen to connections --noListen=VALUE Suppress listening on a TCP port (intended for polling Tentacles only) --listenIpAddress=VALUE IP address on which Tentacle should listen. Default: any --trust=VALUE The thumbprint of the Octopus Server to trust --remove-trust=VALUE The thumbprint of the Octopus Server to remove from the trusted list --reset-trust Removes all trusted Octopus Servers Or one of the common options: --console Don't attempt to run as a service, even if the user is non-interactive --nologo Don't print title or version information --noconsolelogging Don't log to the console
By default, the Octopus Tentacle stores all files in the following folder:
- For Windows Tentacles, the default directory is:
- For Linux Tentacles, the default directory is:
This is known as the Tentacle Home Directory where
<Instance> is an optional instance name in case you have multiple instances of Tentacle on the same computer. This is where both the Tentacle config file and deployment journal is stored.
The Octopus Tentacle stores additional files in sub-folders of the home directory:
- This is where the Calamari packages and other tools are installed so Tentacle can execute deployments on your behalf.
- This is the package cache used to store the most recent packages in case they need to be used again.
- This is where the Tentacle log files are stored.
- This is the temporary working directory used when Tentacle and Calamari execute deployments on your behalf.
Clean up for older Tentacle versions
For Octopus Server versions older than 2020.2, Calamari packages were stored in:
This folder can be safely removed after upgrading to a newer version.
Once a 2.6 Tentacle has been migrated to a modern version the following folders can also safely be removed:
In this section
The following topics are explained further in this section:
Need support? We're here to help.