⚡ Quickly setup my Raspberry Pi with Ansible !
53
stars
291
commits
Shell
primary language
Sep 7, 2026
updated
README
Raspberry Pi Setup
This Ansible playbook is designed to rapidly set up your Raspberry Pi.
It's compatible with all models. It has been successfully tested on multiple models, including the Pi Zero W, Pi Zero 2W, and Pi 4B, among others. The playbook should work well on both Debian and Debian-based distributions.
Roles
Choose which components to install by using tags. Each tag installs specific packages and configurations :
Roles installation :
| Tag | Description | Notes |
|---|---|---|
| standard, std | Core installation and configuration | standard packages, bashrc, vimrc |
| ap | start a hotspot when no Ethernet cable is plugged in | Useful for mobile use to access tools. → AP config file (Access with ssh $USER@10.0.0.1) |
| display | Configure display with LCD-show | Need to modify this file to configure the correct display. |
| docker | Docker installation | Container runtime environment |
| jackit | jackit installation | Exploit Code for Mousejack |
| tor | Tor installation | See README |
| rfid | RFID tools installation | Tools (libnfc, mfoc, mfcuk) and keys from MifareClassicTool → See Notes |
| sdr | SDR tools installation | rtl_433, rtl_sdr, multimon-ng and SoX |
| web | Nginx and Certbot installation | |
| wifi | Wifi and GPS tools installation | Wireless security testing and wardriving |
Containers installation :
| Tag | Description | Notes |
|---|---|---|
| jd2 | docker container for JDownloader 2 jlesage/jdownloader-2 | See Configuration tips' |
| portainer | Portainer CE - a lightweight service delivery platform for containerized applications portainer/portainer-ce | Containers manager |
| proxy | Rotating Tor HTTP proxy container | Provides one HTTP proxy endpoint with many concurrent tunnels to the Tor network. |
Standalone
To setup directly from the Pi, run the following command : Before run command you must setup your Pi with Raspberry Pi Imager.
Next run command :
curl -s https://raw.githubusercontent.com/atao/raspberrypi-setup/main/install.sh | bash -s -- all
Ansible
To setup run the following command :
git clone https://github.com/atao/raspberrypi-setup.git
cd raspberrypi-setup
sudo ansible-playbook playbook.yml -i hosts --tags all -K
List playbook tasks :
sudo ansible-playbook playbook.yml -i hosts --list-tasks
Examples
Install only some tags :
curl -s https://raw.githubusercontent.com/atao/raspberrypi-setup/main/install.sh | bash -s -- standard,proxy,rfid,docker,web,jd2
Debug
Yaml lint
yamllint playbook.yml roles/
Check syntax :
--syntax-check
--
Inspired from geerlingguy / mac-dev-playbook and nico2che / mac-setup
Contributors
291 commits
Similar repos
Languages
Shell
69.5%
Jinja
21.8%
Python
8.8%
⚡ Quickly setup my Raspberry Pi with Ansible !
53
stars
291
commits
Shell
primary language
Sep 7, 2026
updated
README
Raspberry Pi Setup
This Ansible playbook is designed to rapidly set up your Raspberry Pi.
It's compatible with all models. It has been successfully tested on multiple models, including the Pi Zero W, Pi Zero 2W, and Pi 4B, among others. The playbook should work well on both Debian and Debian-based distributions.
Roles
Choose which components to install by using tags. Each tag installs specific packages and configurations :
Roles installation :
| Tag | Description | Notes |
|---|---|---|
| standard, std | Core installation and configuration | standard packages, bashrc, vimrc |
| ap | start a hotspot when no Ethernet cable is plugged in | Useful for mobile use to access tools. → AP config file (Access with ssh $USER@10.0.0.1) |
| display | Configure display with LCD-show | Need to modify this file to configure the correct display. |
| docker | Docker installation | Container runtime environment |
| jackit | jackit installation | Exploit Code for Mousejack |
| tor | Tor installation | See README |
| rfid | RFID tools installation | Tools (libnfc, mfoc, mfcuk) and keys from MifareClassicTool → See Notes |
| sdr | SDR tools installation | rtl_433, rtl_sdr, multimon-ng and SoX |
| web | Nginx and Certbot installation | |
| wifi | Wifi and GPS tools installation | Wireless security testing and wardriving |
Containers installation :
| Tag | Description | Notes |
|---|---|---|
| jd2 | docker container for JDownloader 2 jlesage/jdownloader-2 | See Configuration tips' |
| portainer | Portainer CE - a lightweight service delivery platform for containerized applications portainer/portainer-ce | Containers manager |
| proxy | Rotating Tor HTTP proxy container | Provides one HTTP proxy endpoint with many concurrent tunnels to the Tor network. |
Standalone
To setup directly from the Pi, run the following command : Before run command you must setup your Pi with Raspberry Pi Imager.
Next run command :
curl -s https://raw.githubusercontent.com/atao/raspberrypi-setup/main/install.sh | bash -s -- all
Ansible
To setup run the following command :
git clone https://github.com/atao/raspberrypi-setup.git
cd raspberrypi-setup
sudo ansible-playbook playbook.yml -i hosts --tags all -K
List playbook tasks :
sudo ansible-playbook playbook.yml -i hosts --list-tasks
Examples
Install only some tags :
curl -s https://raw.githubusercontent.com/atao/raspberrypi-setup/main/install.sh | bash -s -- standard,proxy,rfid,docker,web,jd2
Debug
Yaml lint
yamllint playbook.yml roles/
Check syntax :
--syntax-check
--
Inspired from geerlingguy / mac-dev-playbook and nico2che / mac-setup
Similar repos
Contributors
291 commits
Languages
Shell
69.5%
Jinja
21.8%
Python
8.8%