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.
Choose which components to install by using tags. Each tag installs specific packages and configurations :
| 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 |
| web | Nginx and Certbot installation | |
| wifi | Wifi and GPS tools installation | Wireless security testing and wardriving |
| 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. |
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
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
Install only some tags :
curl -s https://raw.githubusercontent.com/atao/raspberrypi-setup/main/install.sh | bash -s -- standard,proxy,rfid,docker,web,jd2
Yaml lint
yamllint playbook.yml roles/
Check syntax :
--syntax-check
--
Inspired from geerlingguy / mac-dev-playbook and nico2che / mac-setup