Rigs

This repository aims to organize the setup automation for my personal rigs. Each rig is added to a given host group, being one of the following:

• Workstation: Allowed to code and execute projects

• Farmer: Responsible for farming Chia

• Harvester: Responsible for plotting Chia

• Table of contents

  • Install
  • Usage
  • Available playbooks
  • Adding a new rig
  • License

Install

Before launching any playbook, you need to install the following tools:

• Ansible

After installing those dependencies, you need to setup your control node SSH keys and setup all your rigs by following the steps in "adding a new rig". Finally, you can duplicate the example inventory with the command:

cp inventory.yaml.example inventory.yaml

And edit it by changing your node IPs to their proper value.

Usage

To use my automation, you can choose a playbook in the "available playbooks" section and them run the following command:

ansible-playbook -i inventory.yaml <the-desired-playbook>

Available playbooks

• setup: Setup all your hosts based on their roles
• setup-workstations: Setup only our workstation hosts
• setup-chia: Setup all my Chia nodes
• setup-farmers: Setup all my farmers (both Chia and Flax)
• setup-chia-farmers: Setup only our Chia farmer hosts
• setup-chia-harvesters: Setup only our Chia harvesters hosts
• setup-flax-farmers: Setup only our Flax farmer hosts

Adding a new rig

The following steps are suggested for my farmer and harvester rigs. If you're bootstrapping a new workerstation rig, you should check my Notion runbook

1. Get the rig IP

If the rig is in your local network, you can get it by running the following command:

ip a

2. Copy your SSH credential to the rig

Knowing the rig user and password, you can run the following command to copy your SSH credential:

ssh-copy-id -i ~/.ssh/id_ed25519 <user>@<rig-IP>

IMPORTANT: You must install the OpenSSH server on the remote rig before running this command

3. Login to the rig shell

ssh <user>@<rig-IP>

4. Remove the rig user password

First, change your sudo user to allow NOPASSWD. You need to run:

sudo visudo

Them, you can add the following line to that file:

ff-farmer ALL=(ALL) NOPASSWD:ALL

IMPORTANT: Don't forget to change ff-farmer with your rig's user

Also, don't forget to enabled passwordless sudo by editing the following line:

# BEFORE
%sudo   ALL=(ALL:ALL) ALL
# AFTER
%sudo  ALL=(ALL:ALL) NOPASSWD:ALL

Now, you must delete your user password with the following command:

sudo passwd -d `whoami`

5. Enable autologin

First, launch the following command to edit the getty service:

sudo systemctl edit [email protected]

Now, add the following contents to the file you're editting:

[Service]
ExecStart=
ExecStart=-/sbin/agetty --noissue --autologin <user> %I $TERM
Type=idle

IMPORTANT: Don't forget to change <user> by your rig username

6. Add your rig to our inventory

After finishing the basic setup, go to your control node and add your rig to our hosts. You can do so by copying another rig structure in our all.hosts key and creating your own. We suggest using your machine unique identifier (use cat /etc/machine-id to find yours) as your machine-id.

License

Distributed under the Apache 2.0 License. See LICENSE for more information.