# Install server updates

> See which plugins, mods and packs have a newer build for your server, and install the updates from the Software tab.

Source: https://www.coritan.com/docs/managed-containers/updates/

In the dashboard:

- /dashboard/servers/…/updates: https://www.coritan.com/dashboard/servers

The **Updates** tab lists the plugins, mods, datapacks and Bedrock packs on your server that have a newer build. It covers what you installed from the [marketplace](/docs/managed-containers/software/plugins-and-mods/), since we know where each of those came from. Files you uploaded yourself are not checked.

## Before you begin

- The server software and a modpack are not listed here. Move those to a new version under **Server software** on the **Software** tab, as [Change the server software](/docs/managed-containers/software/) describes.
- On a server someone shared with you, installing an update needs the Install software permission.

## See which updates are available

1. In the [dashboard](https://www.coritan.com/dashboard/servers), go to **Container Apps** and open the server, then the **Updates** tab.
2. Read the list. Each row shows the **Package**, the **Current** build on the server, the build that is **Available** and the **Source** it comes from.
3. To check again, select the refresh button next to the title.

We only offer a build that fits the server's software and game version. We prefer release builds over beta and alpha builds, and offer a build only when it is newer than the one installed.

## Install an update

The **Install** and **Install all** buttons on the **Updates** tab do not work at the moment: they fail with `Could not queue the update`. Install updates from the **Software** tab instead:

1. Open the **Software** tab, then **Installed addons**.
2. Find the addon. A row with an update shows a badge that names the new build, for example `Update to 2.11.0`.
3. Select **Update** on its row.

We remove the old file and install the new build as a job, which the **Software** tab follows. The new build loads the next time the server starts. [Manage installed addons](/docs/managed-containers/software/installed-addons/) has the details.

## Result

When every tracked addon is on its newest compatible build, the tab shows **Everything is up to date**.

## Troubleshooting

`Could not queue the update`
: The buttons on the **Updates** tab fail at the moment. Update the addon from **Installed addons** on the **Software** tab.

**Could not check for updates**
: We could not reach a source to compare builds. Select **Try again**, or check again later.

An addon you installed is missing from the list
: The list shows only addons with a newer build that fits your server. A file you uploaded yourself, or copied in with an import, is never checked.

## Related

- [Manage installed addons](/docs/managed-containers/software/installed-addons/)
- [Install plugins, mods and modpacks](/docs/managed-containers/software/plugins-and-mods/)
- [Change the server software](/docs/managed-containers/software/)

## With the API

`GET /api/v1/client/servers/{uuid}/updates` returns `{"updates": […]}` with one entry per addon that has a newer build:

```json
{
  "updates": [
    {
      "record_uuid": "3f2c8a61-0d4e-4b7a-9e15-6a2b7c9d0e41",
      "display_name": "LuckPerms",
      "kind": "plugin",
      "source_name": "Modrinth",
      "install_path": "/plugins/LuckPerms-Bukkit-5.4.141.jar",
      "current_version": "vKq6e7Sf",
      "current_version_name": "5.4.141",
      "latest_version": "Rk3eYx1m",
      "latest": {"version_id": "Rk3eYx1m", "name": "5.4.145", "release_date": "2026-09-12T08:30:00Z", "version_type": "release"},
      "update_available": true,
      "checked_at": "2026-09-25T14:30:00+00:00"
    }
  ]
}
```

`current_version` and `latest_version` are the source's own build ids, and `current_version_name` and `latest.name` are the version names people read. To install an update, send `POST /api/v1/client/servers/{uuid}/software/{record_uuid}/update` with the entry's `record_uuid`, as [Manage installed addons](/docs/managed-containers/software/installed-addons/#with-the-api) shows. `GET /api/v1/client/servers/{uuid}/software/updates` gives the same check with more options.

Any user on the server can read the list.

## API

- `GET /api/v1/client/servers/{uuid}/updates`: Get available updates for server software (https://www.coritan.com/docs/api/reference/client/container-apps/servers/#op-get-api-v1-client-servers-uuid-updates)
