Releases - guydavis/machinaris GitHub Wiki

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

Releases of Machinaris can be found on:

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. Uses the released version of Chia. (ChangeLog)
  • TEST: ghcr.io/guydavis/machinaris:test --> Generally holds upcoming changes, stable enough for testing out the new stuff, updates weekly on average. Uses the release candidate of Chia. (ChangeLog)
  • DEVELOP: ghcr.io/guydavis/machinaris:develop --> Changes regularly as development happens, not stable, updates daily on average. Uses the a development version of the Chia blockchain. 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

On Unraid, you can edit the Machinaris container configuration by changing the "Repository" line to end in :develop or :test instead of :latest.

Downgrading

NOTE: Sometimes a downgrade is not advised. For example, if the version of Chia is newer in :develop images than in :latest, then results may not be as you expect. You're better to wait on :develop for a full release, then switch :latest when all streams are identical.

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!