Updates & Maintenance

update - Update Components

Update Apito engine, console, or the CLI itself.

Usage:

apito update <engine|console|self> [-v <version>]

Examples:

# Update engine to latest version
apito update engine

# Update console to a specific version
apito update console -v v1.2.3

# Update the CLI itself to the latest version
apito update self

Automatic Version Management

The CLI automatically manages engine and console versions with smart update detection:

How It Works:

1. During apito init (Docker mode):

   • Automatically fetches latest versions from GitHub releases
   • Stores versions in ~/.apito/config.yml
   • Generates docker-compose.yml with specific version tags

2. During apito start (Docker mode):

   • Checks for newer versions available on GitHub
   • Prompts user if updates are found
   • Allows selective updates (engine only, console only, or both)
   • Automatically pulls new Docker images
   • Regenerates docker-compose.yml with updated versions

Version Storage:

Versions are stored in ~/.apito/config.yml:

mode: docker
engine_version: v1.3.1
console_version: v2.5.0

Update Workflow:

# Start will check for updates
$ apito start

# If updates are available, you'll see:
🆕 Updates Available

  Engine: v1.3.0 → v1.3.1
  Console: v2.4.0 → v2.5.0

? Choose update action:
  ▸ Update Engine (v1.3.0 → v1.3.1)
    Update Console (v2.4.0 → v2.5.0)
    Update Both
    Skip Updates

# After selecting, the CLI will:
✓ Pulling Docker image: ghcr.io/apito-io/engine:v1.3.1
✓ Successfully pulled ghcr.io/apito-io/engine:v1.3.1
✓ Updated engine to v1.3.1
✓ docker-compose.yml updated

Benefits:

• Consistent Deployments: Version pinning prevents unexpected breaking changes
• Easy Rollback: Simply edit config.yml to downgrade if needed
• Transparent Updates: Always know what version you're running
• Offline-Friendly: Uses cached images if GitHub is unreachable

Manual Version Control:

You can manually set versions in config.yml:

engine_version: v1.2.0 # Downgrade to specific version
console_version: latest # Use latest tag

Then regenerate docker-compose.yml:

apito init  # Will respect your manual version settings