Keys
On first run of Machinaris as fullnode or farmer, you'll need to either import a key or generate a new one. (Note, if running a stripped down Machinaris worker such as a harvester or plotter, the private key is not necessary.)
If browsing to your localhost running Machinaris, you may simply enter your 24-word single-space single-line mnemonic seed phrase into the form shown. Machinaris will write it to /root/.chia/mnemonic.txt in the container, add to the Chia keys, and start services.
If not browsing localhost, you may prefer to enter the mnemonic directly into a file yourself, then restart the Machinaris container. Details below.
If you don't have an existing private key to import, just launch Machinaris and browse to the WebUI on port 8926. You'll be presented with a screen where you can choose to have one generated for you. Just click 'Generate New Key' to proceed.
Click the link 'Settings | Keys' in Machinaris to view public key details. Alternatively, you can execute the chia show wallet command from in-container (docker exec -it machinaris bash)
However, the Machinaris WebUI won't show your existing private key for security. To view private key details securely, you need to access the file described above on your host filesystem.
Your new key can be found at /root/.chia/mnemonic.txt in the container. This usually maps to these locations on the host OS:
- Linux:
~/.machinaris/mnemonic.txt - Windows:
C:/Users/USERNAME/.machinaris/mnemonic.txt - Unraid:
/mnt/user/appdata/machinaris/mnemonic.txt
Alternatively execute chia wallet show --show-mnemonic-seed from in-container (docker exec -it machinaris bash).
After initial import, when chia keys add has already been run to initialize Chia services, there is no need to keep your mnemonic pass-phrase on disk anymore. As such, after you have safely saved your pass-phrase, you are strongly encouraged to delete this file. In-container path /root/.chia/mnemonic.txt usually maps to these locations on the host OS:
- Linux:
~/.machinaris/mnemonic.txt - Windows:
C:/Users/USERNAME/.machinaris/mnemonic.txt - Unraid:
/mnt/user/appdata/machinaris/mnemonic.txt
NOTE Treat your mnemonic pass-phrase as a critical password. Do not lose this pass-phrase as there is no recovery if you do!
All Chia users, including all Machinaris users, are strongly encouraged to create a cold wallet to send any wins/payouts. See How To Create A Cold Wallet For Chia Coin and Chia Forks - a great video tutorial by Digital Spaceport:
Plotman supports an optional Archive feature that will copy completed plots to an archive disk via rsync. It relies upon the plotman process in-container to be able to ssh as the configured archive user into your rsync server. To add the required SSH private at start-up of the machinaris container, add the following to your docker run:
On Windows:
C:\Users\USER\.ssh\id_rsa:/id_rsa:ro
On Linux:
/Users/USER/.ssh/id_rsa:/id_rsa:ro
Be sure to change the USER name. This will mount your id_rsa private key file in the container read-only, configuring the local SSH to use it when connecting out to your rsync server.
Then you'll need to run plotman archive from the in-container CLI which will send plots when completed. For details on configuring the destination rsync server, see the Plotman wiki.
To manually add your file, with an existing mnemonic-seed (24 words, space-separated, single-line) to use, place the single line into a text file named mnemonic.txt in above /home/user/.machinaris or similar (/mnt/user/appdata/machinaris on Unraid) host volume. In-container, this will be found at /root/.chia/mnemonic.txt.
If you want to use more than one mnemonic key file, you can pass them as a colon-separated list of in-container paths for example:
-e keys="/root/.chia/mnemonic1.txt:/root/.chia/mnemonic2.txt"
You can even use a separate read-only volume to mount just your mnemonic.txt at startup. For example, if your mnemonic is in ~/keyfile on your host, then pass -v ./keyfile:/root/.chia/mnemonic.txt:ro