Ongoing Maintenance

After the initial configuration, Octopus Deploy will happily continue without much day-to-day maintenance. That being said, It performs at its best when routine maintenance is performed.  

Self-Hosted Octopus Deploy

Customers electing to self-host Octopus Deploy take on the responsibility for maintenance of the Octopus Server.  Our recommendations are:

  • Perform routine database maintenance, such as rebuilding indexes, regenerating statistics, and creating backups.  For more details, please see our section on routine database maintenance.
  • Keep your instance updated with the latest version of Octopus Deploy.  In addition to new features, we also release bug fixes, security patches, and performance improvements.  We have a major release of Octopus Deploy every quarter, with patch releases every one to five days. You can automate your upgrades by following our upgrade guide.
  • Configure lifecycle retention policies.  By default, Octopus Deploy will keep every deployment in its system forever. Initially, that isn’t a terrible thing, but Octopus Deploy will consume more and more data as time goes on. That can be changed by configuring a retention policy to match your internal business rules.  For more details, please see our section on retention policies.
  • Configure package retention policies (when using the built-in feed).  Like deployments, Octopus will keep every package in the internal feed forever. The package retention policy controls this. It is a separate setting, as you might have different rules for deployments than you do for packages.  For more details, please see our section on built-in feed retention policy.

Octopus Cloud

Customers using Octopus Cloud don’t have the same maintenance responsibilities for Octopus Server as customers who elect to self-host.  On Octopus Cloud, we handle all the upgrades and database maintenance for you.

We impose storage limits on your instance to keep your file consumption and database size as small as possible.

  • All lifecycle retention policies have a default of 30 Days instead of forever.
  • The internal package feed retention policy is also defaulted to 30 Days.

Professional instances can change these limits.

Octopus Cloud and Self-Hosted Octopus Deploy

Customers on either platform will need to make some configuration changes to keep Octopus Deploy running smoothly.

  • Configure runbook retention policies.  Each runbook has its own retention policy.  The default is 100 runbook runs per environment.  For more details, please see our section on runbook retention policies.
  • Leverage machine policies to verify deployment target health.  You can configure a custom interval to check the health, and if any machine reports unhealthy, you can trigger a notification.  By default, they run a health check every hour.  Perhaps that is too often or not often enough.  You are most likely deploying to machines in your test environment dozens of times per day. If one were unhealthy, you’d know about it.  While your targets in pre-production or staging environments might not get as many deployments, so you’d want to verify the health more often.  Please see our section on machine policies to modify them to meet your needs.

Help us continuously improve

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

Send feedback

Page updated on Monday, July 15, 2024