calychas / ansible-pi

Setup your RPI from scratch with one command!

Raspberry PI setup with Ansible

Setup your RPI from scratch with only one command!

Description

This repository contains Ansible tasks needed to setup the following modules on RPI:

• periodical autoupgrade
• bigger SWAP
• GIT config
• secure SSH and generate key
• ZeroTier
• pyenv
• cups and airsane for printers
• docker (also moves docker files to a USB to save storage on the internal SD card)
• personal projects

Getting Started

Dependencies

• Python (tested on 3.11.6 and Linux) on the host
• Raspberry Pi with a debian-based OS (tested on Raspberry Pi OS 64-bit bookworm and RPI 3B+). See Raspberry Pi OS Imager if you didn't install it yet.

Installing

You need to install Ansible. For that use:

pip install -r requirements.txt

Copy and fill out the following files:

1. inventory.yml.example as inventory.yml - change user and host
2. main.yml.example as main.yml - supply missing vars, optionally comment out or edit the tasks

Executing

First debug the connection:

ansible-playbook -i inventory.yml debug.yml

If everything works, run the full suite:

ansible-playbook -i inventory.yml main.yml -vv

Authors

• Kacper Leśniara ([email protected])

License

This project is licensed under the MIT License - see the LICENSE.md file for details

ansible-pi's Issues

add oh-my-zsh

Maybe transition the repository to a cookiecutter template

Add testing environment

See

• https://dev.to/pencillr/test-ansible-playbooks-using-docker-ci0
• https://docs.ansible.com/ansible/latest/reference_appendices/test_strategies.html
• https://medium.com/@yortuc/testing-ansible-playbooks-with-vagrant-722619986013

Docker repo is hardcoded to bullseye