Skip to content

Stable releases will be published every 3 months. These stable releases will come after a beta cycle has been concluded.

Patch releases may be issued on Fridays, once every two weeks, if there is a compelling need (e.g. an urgent bug fix).

In addition to the stable channel there is also a beta channel, for which there is a dedicated Home Assistant App (and docker image) and documentation. Once a new stable version has been published, a new beta cycle will start (with the minor version increased). For example, once stable version 2.8 is released, the beta for version 2.9 starts.

Beta releases are planned to be released every Friday. In some cases, when a large feature is in development for example, expect multiple beta releases per week.

Each night, if there are at least two PRs merged, an automated Nightly Release will be built. Install this version if you want to keep up with the latest bleeding edge development of Music Assistant! Use it at your own risk, it might not be recommended for daily/production use because it can be unstable.

This is a special development App for Music Assistant that allows developers to quickly test specific branches (frontend and backend), pull requests, or even forks of Music Assistant directly in Home Assistant.

It is possible to run the stable, beta, nightly or dev server apps side by side as they don’t share any data. For example, you can temporarily run the beta app to try out new features and then revert to the stable version. You can do this by manually stopping and starting the relevant server. Don’t have two servers running on the same host at the same time.

CAUTION

Be careful that you don’t accidentally remove an App, because that will result in the loss of all your data (if you didn’t back it up). The same applies to docker users: be careful with the data folder and be aware that the data folder is not backwards compatible. Don’t try to use it between channels!