> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to update the SimplyPrint Client (in-app, Docker, Linux and release channels)

# How to update the SimplyPrint Client (in-app, Docker, Linux and release channels)

New SimplyPrint Client versions ship fixes and new printer support all the time, so updating is the first thing to try when something misbehaves. This guide shows how to update from inside the Client, what to do on Docker, Homebrew and over SSH, and how the Stable and Canary release channels work.

| Updating does not stop running prints. The prints run on the printers themselves, so you can update while they print.

## What this guide covers
- [Check which version you are on](#2-check-which-version-you-are-on)
- [Update from inside the Client](#2-update-from-inside-the-client)
- [What an update does to running prints](#2-what-an-update-does-to-running-prints)
- [Stable and Canary release channels](#2-stable-and-canary-release-channels)
- [Docker: "Managed externally"](#2-docker-managed-externally)
- [Homebrew on a Mac](#2-homebrew-on-a-mac)
- [Update by hand over SSH (Linux and Raspberry Pi)](#2-update-by-hand-over-ssh-linux-and-raspberry-pi)
- [Windows portable zip](#2-windows-portable-zip)

## Check which version you are on
1. Open the Client: **http://localhost:8000** on the device it runs on, or **http://<device-ip>:8000** from another computer.
2. Go to **Settings** > **About**. **Version** shows what you run.

**Check:** a version like **1.0.0-rc.23** is the SimplyPrint Client. A version like **1.0.0-beta.117** is the old SimplyPrint Bambu Lab client, which no longer gets updates - move to the new Client with [Migrating from the SimplyPrint Bambu Lab client to the new SimplyPrint Client](https://help.simplyprint.io/en/article/migrating-from-the-simplyprint-bambu-lab-client-to-the-new-simplyprint-client-1921hju/).

Don't mix this up with the Cloud Slicer version in SimplyPrint. The Client version is only shown in the Client itself.

## Update from inside the Client
This works for the Windows installer, the Mac installer, the Linux installer and the Raspberry Pi image.

1. Open the Client and look at the status menu in the **bottom-left corner**. When an update is ready, it says so there.
2. Or go to **Settings** > **About** and click **Check**.
3. Click **Install update**.
4. The Client downloads the update and restarts itself. The page comes back after the restart.

**Check:** **Settings** > **About** shows the new version, and your printers are online again.

Updates are opt-in. The Client checks for a new version every hour and tells you, but it only installs when you click the button. If a new version fails to start, the Client goes back to the version that worked.

## What an update does to running prints
Nothing. The Client restarts, the printers keep printing, and they come back online in SimplyPrint when the Client is up again.

The one thing to know: while the Client restarts, it can miss an event, such as a print finishing in exactly that moment. Then SimplyPrint doesn't learn how that print ended.

## Stable and Canary release channels
Stable is the default and the recommended channel. Canary gets new versions earlier, with less testing - useful when a fix you need is only on Canary for now.

1. Go to **Settings** > **About** > **Update channel**.
2. Pick **Stable** or **Canary**.
3. Scroll up to **Updates** and click **Check**.

**Check:** **Install update** appears when the channel you picked has a version you don't have yet.

Not every Stable version is also built for Canary. If you are on Canary and a newer Stable version is out, switch back to Stable and click **Check** again.

## Docker: "Managed externally"
In Docker, **Settings** > **About** shows **Managed externally** and the **Check** button is greyed out. That is expected: a container cannot replace itself, so you update it by pulling the new image and recreating the container. Your printers and settings live in the `simplyprint_data` volume, so they survive.

With `docker run`:
1. Run `docker pull simplyprint/simplyprint-client`.
2. Run `docker stop simplyprint-client`, then `docker rm simplyprint-client`.
3. Start it again with the same `docker run` command you used to install it, including `-v simplyprint_data:/root/.config/SimplyPrint`.

With Docker Compose:
1. In the folder with your `compose.yaml`, run `docker compose pull`.
2. Run `docker compose up -d`. Compose recreates the container on the new image.

**Check:** **Settings** > **About** shows the new version, and your printers are still there.

||| `docker restart` on its own is not enough. It restarts the existing container on the old image.

The image tag sets the release channel: `simplyprint/simplyprint-client` (the `latest` tag) is Stable, and `simplyprint/simplyprint-client:canary` is Canary.

## Homebrew on a Mac
If you installed with Homebrew, **Settings** > **About** shows **Managed by Homebrew**. Click **Update** there, or run `brew upgrade simplyprint/tap/simplyprint-client` in Terminal.

**Check:** the Client comes back with the new version in **Settings** > **About**.

## Update by hand over SSH (Linux and Raspberry Pi)
If the in-app update fails, run the installer again. It replaces the program and keeps your printers and settings.

1. Connect to the device over SSH (or open a terminal on it).
2. Run `sudo bash -c "$(curl -fsSL https://download.simplyprint.io/client/install-linux.sh)"`.
3. Wait for it to finish. It stops the running Client, installs the new version and starts it again.

**Check:** **Settings** > **About** shows the new version. If the Client still won't start, restart the device.

## Windows portable zip
The portable zip build does not update itself. Download the new zip, or switch to the [Windows installer](https://download.simplyprint.io/client/SimplyPrintClient-Setup-x64.exe), which updates from inside the Client. Quit the running Client before you install.

For the Home Assistant add-on, see [Run the SimplyPrint Client as a Home Assistant add-on](https://help.simplyprint.io/en/article/run-the-simplyprint-client-as-a-home-assistant-add-on-ab2n8m/).

## Related articles
- [How to install the SimplyPrint Client](https://help.simplyprint.io/en/article/how-to-install-the-simplyprint-client-on-a-raspberry-pi-windows-mac-linux-docker-or-chromebook-t71fxl/)
- [Manage the SimplyPrint Client: logs, password, backups and printers](https://help.simplyprint.io/en/article/manage-the-simplyprint-client-logs-password-backups-and-printers-6bx4n/)
- [Migrating from the SimplyPrint Bambu Lab client to the new SimplyPrint Client](https://help.simplyprint.io/en/article/migrating-from-the-simplyprint-bambu-lab-client-to-the-new-simplyprint-client-1921hju/)
- [Why is my printer offline?](https://help.simplyprint.io/en/article/why-is-my-printer-offline-jzctwn/)