Updates

Update Buddy self-hosted regularly to stay up-to-date with new features, bug fixes, and improvements.

Warning
All commands listed in the article must be run as root.

Checking the version

To check your version of Buddy and Buddy CLI, run:

buddy version$

Updating Buddy Self-Hosted

To update your Buddy instance, follow these steps:

  1. Sign in to the machine where Buddy self-hosted is installed.
  2. Stop the application:

    buddy stop$
  3. Run this command to check if an update is available:

    buddy update$
  4. If a new version is available, Buddy shows the version number and instructions for getting the update.
  5. Download the new version.
  6. Start Buddy CLI. Run:

    buddy$
  7. Run this command to update your instance:

    buddy update$

The update can take several minutes. Don't close the terminal until the update is complete.

Warning
When you start the update, Buddy creates a backup, saves it into the default location, and removes older backups. You can change this behavior by using flags with the buddy update command. Read this document to learn more about backups.

Running out of space during the update

If the update procedure fails, it's usually because there's not enough disk space to complete the process.

Here's what you can do to successfully resume the installation:

  1. Free up the space on the disk where Buddy self-hosted is installed. Make sure to free at least double the amount your application occupies in ~/.buddy/app/data.
  2. Remove all backups in the ~/.buddy/app/backups directory except the latest file.
  3. Restore the application to the latest backup:

    buddy restore$
  4. Run the update again:

    buddy update$
Hint
If you’re low on space in the default install location, you can move the whole application to another location using Buddy CLI.
Last update:
Sep 24, 2024