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
multitor	install a proxy with multiple TOR instances with load-balancing (trimstray/multitor)	Known issues
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

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