Occasionally, it may be necessary to change the location at which Octopus stores its data (called the “Octopus Home” folder) as well as the Registry Key which defines the Octopus Server instance, you may also want to clean up the Octopus Home folder after migrating from Octopus Server 2.6 to a modern version of Octopus Server. This page will explain what settings can be configured using the command-line on the Octopus Server and what folders can safely be removed from the Octopus Home folder after successfully migrating to a modern version of Octopus Server.
Make sure you have a current backup of your Octopus data before proceeding. You will also need your Master Key if you need to use the backup, so please copy that also!
Server configuration
If you need to re-configure your Octopus Server instance, you can do that using the Octopus Server configure command.
Server folders
If you need to move folders other than the Octopus Home folder, you can do that using the Octopus Server path command. Also see moving Octopus Server folders.
File storage
The Octopus Server stores files in the following folders by default:
C:\Octopus- This is where the Octopus Server config file and deployment journal is stored.
- See this page on how to move the Octopus home folder
C:\Octopus\Artifacts- This is where artifacts created by deployments are stored.
- See this page on how to move the Octopus Server artifacts folder
C:\Octopus\Logs- This is where the Octopus Server log file is stored.
C:\Octopus\OctopusServer\PackageCache- This is where the signature and delta files used for package acquisitions are stored.
C:\Octopus\Packages- This is where the packages pushed to the Octopus Server built-in package repository are stored.
- See this page on how to move the Octopus Server built-in package folder
C:\Octopus\TaskLogs- This is where all logs from deployments and other server tasks are stored.
- See this page on how to move the Octopus Server task logs folder
C:\Octopus\Telemetry- This is where all performance and other temporal telemetry files are stored.
- See this page on how to move the Octopus Server telemetry folder
C:\Octopus\Imports- This is where imported zip files are stored when using the Export/Import Projects feature.
- See this page on how to move the Octopus Server imports folder
C:\Octopus\EventExports- This is where audit log archive zip files are stored when using the Archived audit logs feature.
- See this page on how to move the Octopus Server event exports folder
Clean up post-2.6 migration
In Octopus 2.6 the Server stored files in the following folders by default:
C:\OctopusC:\Octopus\BackupC:\Octopus\LogsC:\Octopus\OctopusServerC:\Octopus\OctopusServer\ActivityLogsC:\Octopus\OctopusServer\ActorsC:\Octopus\OctopusServer\Repository\IndexC:\Octopus\OctopusServer\Repository\PackagesC:\Octopus\PackageCacheC:\Octopus\RavenDB
Once you have migrated to a modern version of Octopus Server the following folders can safely be removed:
C:\Octopus\BackupC:\Octopus\OctopusServer\ActivityLogsC:\Octopus\OctopusServer\ActorsC:\Octopus\OctopusServer\RepositoryC:\Octopus\PackageCacheC:\Octopus\RavenDB
Help us continuously improve
Please let us know if you have any feedback about this page.
Page updated on Sunday, January 1, 2023