TrueNAS - guydavis/machinaris GitHub Wiki

Start a Discussion or join our Discord Server for Machinaris support and to help out other users.

TrueNAS Scale

For a short while, a broken TrueNAS application template existed for Machinaris that pinned a version number. This deployment generally lagged about a month or more behind our :latest release. So TrueNAS users were always out of date, and thus missing blockchain security fixes, experienced SSL cert expirations, saw blockchain sync blockages, among other issues. As well, easy deployment of workers was not supported.

TrueNAS, which relies upon a heavy-weight Kubernetes deployment, is simply not as flexible and user-friendly as other plaforms for app deployment such as Linux, Unraid, Windows, etc. As of 2023-03-15, TrueNAS removed their broken application template, so I would recommend running anything other than TrueNAS if you are interested in Machinaris.

TrueNAS SCALE Installation

Below is an old approach that definitely did not work well on this Kubernetes-based platform. I'm leaving it here for posterity.

Storage Configuration

Before deploying the Machinaris application, you will need to provision at least two storage locations. Navigate to the "Storage" section of the UI, and create a dataset for your Machinaris Configuration data, as well as a location where you plan to store your Chia Plots. In this example we created tank/machinaris/config and tank/chia/plots respectively.

Storage Configuration

Note, if you wish to plot using your TrueNAS system, add a third volume (ideally fast SSD or RAMDISK) which maps to /plotting in the container.

Deploying Machinaris v0.5.x

After creation of your Configuration and Plots datasets, it is easy to start the deployment process of the Machinaris application. Navigate over to the "Apps" section and locate the Machinaris application in the default catalog.

Apps Page

Click the Install button to pop-out the application deployment wizard. Enter the name for your application, I.E. "machinaris" and click the Next button.

Install Wizard 1

On the next page, keep the default Web UI port of 9003 and click Next to continue.

Install Wizard 2

Next you can configure your local timezone, select from the drop-down list to locate your preferred time. Click Next to continue.

Install Wizard 3

In the Storage section, you will want to click the button to enable a Custom Host Path for the Machinaris configuration and plots volumes. These are what will ensure that your data persists across deployments, in case you need to upgrade or delete and re-install Machinaris at a later point. Use the file-browser to select the datasets that were created in the storage section. In this example we are using /mnt/tank/machinaris/config and /mnt/tank/chia/plots. After both are selected, click Next to continue.

Install Wizard 4

If you want to set any custom environment variables that persist inside your container, you can do so here. The Machinaris Launch Wizard can be used to help you decide if you need any additional environment variables set here. Otherwise you can leave this empty and click Next to continue.

Install Wizard 5

Lastly, you will be presented with a summary page. Confirm that your options look create, and click Submit to start the deployment.

Install Wizard 6

You will be taken back to the applications page, where you should now see the machinaris application in the deploying state. This can take several minutes to fully deploy, and when finished will change from "Deploying" to "Active". The 'three-dot' menu on the application can be used to launch a Shell, View Logs or perform other management tasks.

Deploying 1

With the application now fully deployed, you can click the Portal button to bring up the Machinaris WebUI and begin setting up your Chia services. Good luck and Happy Farming/Plotting!

Deploying 2

Deploying Machinaris v0.6.0+

Workaround for multi-container Machinaris is provided by Discord user: k2skaterii Thanks much!

"I think I just figured out how to make this work... Just deployed my "Machinaris2" APP on my TN-Scale and I'm now plotting with the madmax plotter that is now a part of the chia install.

I will say my primary reason for wanting to upgrade my plotter to Chia v1.2.11 was because I wanted to see the updated madmax plotter now that "madmax" works for Chia...and start kicking out some K33 or K34 MadMax plots. The inclusion of Bladebit plotter is cool, but doesn't do me much good with a mere 384 GB of RAM in my TrueNAS Scale system - Maybe 32x 32GB sticks will fall off a truck in front of my house soon, you never know."

That being said here's what I did.
SSH'ed into my TN-Scale - navigated to:
/mnt/<pool-name>/ix-applications/catalogs/github_com_truenas_charts_git_master/charts
copied the machinaris folder to machinaris2 folder.
renamed the machinaris2/1.0.11/ to machinaris2/1.0.13/
navigated into the 1.0.13 folder and made the following changes to the specified files.
1.0.13/test_values.yaml:
    tag: v0.6.3
1.0.13/ix_values.yaml:
    tag: v0.6.3
1.0.13/chart.yaml:
    appVersion: v0.6.3
    name: machinaris2
    version: 1.0.13
⚠️ **GitHub.com Fallback** ⚠️