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:

bash
buddy version
$$

Updating Buddy Self-Hosted

To update your Buddy instance, follow these steps:

Sign in to the machine where Buddy self-hosted is installed.
Stop the application:
```
bash
buddy stop
$$
```
Run this command to check if an update is available:
```
bash
buddy update
$$
```
If a new version is available, Buddy shows the version number and instructions for getting the update.
Download the new version.
Start Buddy CLI. Run:
```
bash
buddy
$$
```
Run this command to update your instance:
```
bash
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:

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.
Remove all backups in the ~/.buddy/app/backups directory except the latest file.
Restore the application to the latest backup:
```
bash
buddy restore
$$
```
Run the update again:
```
bash
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 modified on Sep 24, 2024

Telemetry Low storage space