selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
machinaris logo

Self-host machinaris

2.6.0

Docker-based Chia plotting and farming dashboard

DiscontinuedOpen SourceApache-2.0
Updated5 months ago
LanguagePython
Setup difficultyModerate
Stars
340
RAM
16 GB minimum for controller (full-node), 32 GB+ with many forks, 2 GB for harvesters
Storage
150 GB free space for Chia blockchain, more for forks; SSD recommended for appdata
Ports
8926 (Machinaris WebUI), 8927 (Machinaris REST API), 8444 (Chia farmer peer port)
Docker
guydavis/machinaris
Install with Docker Compose
Machinaris home dashboard showing farming overviewPlotting view with Plotman managing MadMax, Gigahorse, and Bladebit plottersPlotting speed performance chart by k-sizePlot archiving transfers to local drives or remote harvestersFarming view showing Chia and fork blockchain statusChiadog alerts example showing log monitoring notificationsDrive health monitoring grid with smartctl statusInitial setup screen for importing or generating key mnemonicSettings page for Chia, Plotman, and Chiadog configurationConnections and blockchain status with geolocation view

What is machinaris?

Machinaris provides a web-based interface for managing Chia cryptocurrency plotting and farming operations. It bundles multiple plotters (MadMax, Gigahorse, Bladebit) managed by Plotman, log monitoring via Chiadog, and supports farming across multiple Chia forks including MMX, Chives, Flax, and HDDCoin. The software runs as a Docker container with a launch wizard for easy docker-compose.yml generation. It supports standalone operation on a single machine or distributed worker management across a LAN with a central controller. Features include drive health monitoring with smartctl, notifications via email/Telegram/Discord/Slack, fast blockchain sync, and a REST API for integration. The project has announced closure due to waning interest in the Chia ecosystem and upstream tool abandonment, but existing installations on Chia 2.6.x should continue working until a breaking change occurs.

Should you self-host machinaris?

machinaris scores 49/100 on selfhost.directory (how scoring works) and ranks #12 of 18 in Blockchain. It has 340 GitHub stars.

It shipped 2 stable releases in the past year. The latest, 2.6.0, came out on 16 February 2026. New versions land roughly every 3 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is geth-ethereum (86/100, 51 451 stars). It scores higher overall, so compare the two before you pick. See machinaris vs geth-ethereum side by side.

Features

  • Configuration via WebUI
  • Connection and blockchain status
  • Container CLI access
  • Drive health monitoring
  • Fast blockchain sync
  • Key Management
  • Log monitoring and alerts
  • Multi-blockchain farming
  • Plot archiving via rsync
  • Plotting performance graphs
  • REST API
  • Web-based plotting management
  • Worker Management

machinaris README

How to install machinaris

Install machinaris with Docker Compose

Use the Launch Wizard to save a docker-compose.yml to your machine. Then docker compose up -d to run Machinaris.

Recommended installation method for all platforms

How to configure machinaris

  • bladebit_skip_buildSkip building Bladebit plotter (set to 'true' to disable)

    Skip building Bladebit plotter (set to 'true' to disable)

    values: true

  • controller_hostIP address of the primary fullnode system (Machinaris controller)

    IP address of the primary fullnode system (Machinaris controller)

  • farmer_addressIP address of the farmer machine

    IP address of the farmer machine

  • madmax_skip_buildSkip building MadMax plotter (set to 'true' to disable)

    Skip building MadMax plotter (set to 'true' to disable)

    values: true

  • plots_dirColon-separated list of container paths for plot directories

    Colon-separated list of container paths for plot directories

  • remote_mountsRemote shares and their local mount paths for network share access

    Remote shares and their local mount paths for network share access

  • TZTimezone for the container

    Timezone for the container

  • worker_addressIP address of the worker machine

    IP address of the worker machine

machinaris releases & version history

FAQ

How can I donate?

The author does not accept donations; instead, share Machinaris with others, star the project on GitHub and Docker Hub, and help new users on Discord.

Can I restart/update the container without killing my plotting jobs?

No, restarting the container kills running plotting jobs. Stop Plotman first to let existing jobs complete, then restart.

Can I send my completed plots to another system when they're done?

Yes, Plotman supports archiving via rsync in the plotman.yaml file to transfer completed plots to a destination server.

Can I use two (or more) temporary plotting directories?

Yes, mount both temp plotting volumes in-container and configure plotman.yaml with multiple tmp entries.

Why doesn't Machinaris offer an authentication mechanism to allow logins?

Machinaris is intended for local area network use only. If you proxy access via a web server, that server should handle authentication.

Can I copy over Chia blockchain and wallet databases from other installs?

Yes, but users report about a 50% success rate. Stop the container, replace the db folders, then restart and check logs.

How can I stop or restart the WebUI?

Use docker exec to enter the container, kill the gunicorn processes, then run /machinaris/scripts/start_machinaris.sh to restart.

Where can I get support?

Support is available through Discord, GitHub Issues, Unraid Support thread, and the Machinaris sub-reddit.

More in Blockchain

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…