Install Raspberry Pi with Pi-hole in Docker.
This guide provides step-by-step information to set up following services on a Raspberry Pi:
| Service | Purpose |
|---|---|
| SSH | Accessing the command line from other devices |
| Samba | Network storage for easy file system access |
| Docker | Run sandboxed applications and servers |
| PiHole | DNS with blacklists for ads (like hosts file for Windows) |
Download and install Raspberry Pi Imager. Run the installer. Insert the SD card and choose it in the UI. Pick an OS
Raspberry Pi OS (Other)
Raspberry Pi OS Lite (64-bit)
In the main menu hit the Settings icon on the bottom right. Use the settings in the image below. Skip the wireless connection setting if you are going to connect the Pi to your router via a LAN cable, which is recommended for this.
After that you can hit write. Once that is done, insert the SD card in your Pi and put some power on it.
Open MS Terminal and type
ssh pi@picloud
If this does not work, look for the Raspberry Pi IP under network information within your router.
Type yes, when asked to trust the fingerprint. Type in password and you will be able to execute commands directly on the Raspberry Pi.
| Hotkey | Action |
|---|---|
| Mark text | Copy marked text |
| Right click | Paste from clipboard |
| Up | Last command |
| CTRL+C | Abort current action Exit |
| CTRL+Q | Sometimes exit |
Run the following commands.
This will clone this repo and start the installation script, which will install Samba and Docker. You have to type your password during installation once and retype it again.
sudo apt-get install -y git \
&& git clone https://github.com/neko-js/rpinas.git \
&& sudo bash ./rpinas/install.sh
Post Docker installation steps:
sudo groupadd docker \
; sudo usermod -aG docker $USER \
; newgrp docker \
; sudo chmod 666 /var/run/docker.sock
Download and run Pi-hole:
docker compose -d -f rpinas/docker-compose.yml up
You must set the DNS on your devices to the IP address of the Raspberry Pi.
You will be able to access Pi-hole under the displayed address or under http://picloud.local/admin
You can also access the home folder within your network. The network connection is:
\\picloud\picloud-home
E.g. go to "This PC" on MS Windows and right click anywhere to create a network connection with this address.