Releases

Start a Discussion or join our Discord for support and to help out.

Releases of Machinaris can be found on:

• GitHub - Packages
• Dockerhub - Tags

The most recent ChangeLog is found on Github.

Release Streams

The following image tags will be available:

• LATEST: ghcr.io/guydavis/machinaris (aka: docker pull ghcr.io/guydavis/machinaris:latest) <-- This is the one you want. Stable release, updates monthly on average. (ChangeLog)
• TEST: ghcr.io/guydavis/machinaris:test --> Generally holds upcoming changes, stable enough for testing out the new stuff, updates weekly on average. (ChangeLog)
• DEVELOP: ghcr.io/guydavis/machinaris:develop --> Changes regularly as development happens, not stable, updates daily on average. Will break! (ChangeLog)

NOTE: Please DO NOT mix versions across containers, for example running :develop version of the main Machinaris container with a released version (:latest) of some forks. When selecting a release stream to run, please set ALL Machinaris containers to the same image version tag. Thanks!

Upgrading

To upgrade to a different stream of Machinaris, simply change the image tag (end of the image line in your docker-compose.yml) from :latest to :test (for example), then:

docker-compose stop
docker-compose rm -f 
docker-compose pull
docker-compose up -d --force-recreate

Downgrading

To downgrade to a different stream of Machinaris, simply change the image tag (end of the image line in your docker-compose.yml) from :test to :latest (for example), then:

docker-compose stop
docker-compose rm -f
rm -f ~/.machinaris*/machinaris/dbs/*.db 
docker-compose pull
docker-compose up -d --force-recreate

Code Branches

• LATEST: Built from the main branch. <-- Receives only final commits - stable and fully tested.
• TEST: Built from the integration branch. <-- Devs, fork and pull request off this branch for fixes and enhancements.
• DEVELOP: Built from the main branch. <-- Active development branch, often broken!