Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify tutorial in ARM32.md #837

Merged
merged 2 commits into from
Sep 21, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 30 additions & 18 deletions .github/ARM32.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,23 +8,35 @@ ourselves.

## Instructions

Use [Raspberry Pi Imager](https://www.raspberrypi.com/software/) to download
Raspberry PI OS lite (32bit) to an SD card

Use the settings to set up a proper hostname and user account.

Take the written SD card and put it into the Raspberry PI

Power it up and wait for it to boot

SSH into the Raspberry PI

Follow Githubs instructions on how to set up a self-hosted runner
https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners

Use all the default values in the `./config.sh` setup step

Use Github instructions to setup the runner as a services so it runs on boot
https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service
### Gathering your Tools

You will need:

- A Raspberry Pi
- A micro SD card
- An SD card reader
- A computer

### Flashing the SD Card
1. Install and open [**Raspberry Pi Imager**](https://www.raspberrypi.com/software/) on your computer
2. In **Raspberry Pi Imager**:
- Select your Raspberry Pi model
- Select "Raspberry PI OS lite (32bit)" as the OS (you may need to look into the sub-menus)
- Select your SD card
- Click NEXT
3. Edit the OS settings:
- Set a hostname (e.g. `processing.local`)
- Set a username and password
- Go to the SERVICES tab and enable SSH with password authentication
- Click SAVE and Apply the OS customisation settings

### Configuring the Raspberry Pi
1. Take the written SD card and put it into the Raspberry PI
2. Power it up and wait for it to boot
3. SSH into the Raspberry Pi using the hostname, username, and password you set earlier
4. Follow Github's [instructions on how to set up a self-hosted runner](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners). _Note: In the `./config.sh` setup step, you will be prompted to enter a name and other settings. Use default settings by pressing ENTER for each prompt._
5. Verify that the new runner appears in the list of runners on GitHub.
6. Quit the the runner in the terminal (we will set it up to run automatically on boot).
7. Use Github [instructions to setup the runner as a services](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service) so it runs on boot.

Done.
Loading