Skip to content

Upgrade

Learn how to upgrade your Piglet Run installation.

Overview

Piglet Run upgrades include:

  • Minor Updates: Bug fixes and security patches
  • Major Upgrades: New features and improvements
  • PostgreSQL Upgrades: Database version upgrades

Quick Upgrade

Upgrade to latest version:

pig upgrade

Check for Updates

View Current Version 

pig version

Check Available Updates 

pig upgrade check

Perform Upgrade

Standard Upgrade 

pig upgrade --backup

Upgrade to Specific Version 

pig upgrade --version 2.5.0

Dry Run 

pig upgrade --dry-run

Upgrade PostgreSQL

Check Compatible Versions 

pig upgrade pg --list

Upgrade Database Version 

pig upgrade pg --version 17

With Full Backup 

pig upgrade pg --version 17 --backup

Before Upgrading

  1. Create Backup

    pig backup create --full

  2. Check Compatibility

    pig upgrade check --verbose

  3. Review Release Notes

    pig upgrade notes

Rollback

If upgrade fails:

Restore from Backup 

pig restore --backup pre-upgrade

Rollback to Previous Version 

pig upgrade rollback

Upgrade History

View upgrade history:

pig upgrade history

Example output:

Version    Date         Status
-------    ----------   -------
2.5.0      2024-01-15   Current
2.4.1      2024-01-01   Previous
2.4.0      2023-12-15   Archived

Configuration

Upgrade settings in /etc/piglet/upgrade.yml:

upgrade:
  auto_backup: true
  notify: true
  channel: stable  # stable, beta, nightly

Next Steps