# Updating on-premise

Please note that the on-premise version differs from the cloud version and is not updated automatically.

## On-premise version release notes

You can follow the updates [here](https://app.getbeamer.com/uibakery/en) with the **`ON-PREMISE RELEASE`** tag.

## Update to the latest version

To update your UI Bakery on-premise version to the latest one, follow the steps below:

1. Take a full backup of the UI Bakery instance.
2. Go to your `ui-bakery-on-premise` folder:

```bash
cd ./ui-bakery-on-premise
```

3. Run `./update.sh` that will download new images and restart your instance:

```bash
./update.sh
```

4. If you use Git to manage your apps in UI Bakery, follow [this guide](https://docs.uibakery.io/concepts/source-control/migrate-your-app-model-to-the-latest-version) to properly migrate the application model.

## Update to the specific version

To update your UI Bakery on-premise version to the specific version, follow the steps below:

1. Take a full backup of the UI Bakery instance.
2. Go to your `ui-bakery-on-premise` folder:

```bash
cd ./ui-bakery-on-premise
```

3. Set the `UI_BAKERY_VERSION` environment variable to the desired version in the `.env` file.
4. Then restart the system.

```bash
# pull new images
docker compose pull
# restart UI Bakery
docker compose down && docker compose up -d
```

5. Optionally delete old images.

```bash
docker image prune -a -f
```

6. If you use Git to manage your apps in UI Bakery, follow [this guide](https://docs.uibakery.io/concepts/source-control/migrate-your-app-model-to-the-latest-version) to properly migrate the application model.

## Updating from version 2.25.0 and lower to the new version

If you are on a <mark style="color:red;">**2.25.0 UI Bakery version or lower**</mark>, please follow the guide below to update to a newer version.

{% hint style="danger" %}
Please note this is a one-time procedure! You need to follow these steps only once to upgrade from any version lower than 2.25.0. If you are on a higher version, please use [this guide](#update-to-the-latest-version).
{% endhint %}

1. Create a backup of `ui-bakery-on-premise` folder:

```bash
cp -R ui-bakery-on-premise ui-bakery-on-premise_old
```

2\. Go to `ui-bakery-on-premise` folder and run:

```bash
curl -k -L -o docker-compose.yml <https://raw.githubusercontent.com/uibakery/self-hosted/main/docker-compose.yml>
```

3\. Comment `UI_BAKERY_WORKBENCH_PATH` variable by adding `#` at the beginning of the line in `.env` file:

```bash
nano .env

#UI_BAKERY_WORKBENCH_PATH=...
```

* Press `control + O` to save.
* Press `control + X` to exit.

4\. Run the next command to rerun containers:

```bash
sudo docker compose build --pull
sudo docker compose pull
sudo docker compose up -d
```

5\. Check your UI Bakery instance.