Upgrades and Routine Maintenance
Keeping TailStatic Current
Regular updates to TailStatic ensure that you have the latest features, performance improvements, and security patches. Because TailStatic is containerized, the upgrade process is straightforward.
Safe Upgrade Order
To update your TailStatic installation:
- Back up your data: Always create a fresh Backups and Restore of the Persistent Storage Layout before upgrading.
- Pull the latest images:
(See the official Docker docs)docker compose pull - Restart the services:
(See the official Docker docs)docker compose up -d
Docker will automatically stop the old Docker Images and Service Roles and start new ones. Your data in the mounted volumes will remain untouched. For a fresh start, see Docker Quickstart.
Health Checks After Upgrading
After an upgrade, verify that the system is functioning correctly:
- Check the Analytics and Logs for any migration errors.
- Verify the connection to TailStatic-Tools and Processing Jobs in the Application Settings.
- Perform a Preview Workflows of one of your sites to ensure the rendering engine is working as expected.
Routine Maintenance
To keep your server running smoothly, perform these periodic tasks:
1. Docker Cleanup
Remove old, unused Docker images and volumes to free up disk space.
2. Log Rotation
TailStatic automatically prunes old application logs, but you should monitor the /app/data/tailstatic/jobs folder in the Persistent Storage Layout.
3. Site History Pruning
If you have a site with a very long Versioning and History, the local Git repository may grow in size. You can perform a manual "Maintenance" task from the site dashboard.
4. Checking SSL Certificates
If you are using a Reverse Proxy and HTTPS, ensure that your SSL certificates are renewing correctly. Check your Network and Domain Planning.
Next Steps
Regularly review your Create and Manage Sites to ensure they are up to date. If you encounter issues during maintenance, refer to Troubleshooting TailStatic. For a quick path map, see the Directory Reference.
