Skip to content

HomeLab On a Raspberry Pi 4

Homelab - Docker based Server¤

This repository is a collection of steps for hosting a variety of server applications using Docker and Portainer on RaspberryPi.


Installing Operating System¤

I recommend the use of Raspberry Pi Imager to install an operating system on to your SD card. You will need another computer with an SD card reader to install the image. Raspberry Pi Imager can be run on another Raspberry Pi, but also works on Microsoft Windows, Apple macOS, and Linux.


Raspberry Pi have developed a graphical SD card writing tool that works on Mac OS, Ubuntu 18.04, and Windows called Raspberry Pi Imager; this is the easiest option for most users since it will download the image automatically and install it to the SD card.

Download the latest version of Raspberry Pi Imager and install it. If you want to use Raspberry Pi Imager from a second Raspberry Pi, you can install it from a terminal using "sudo apt install rpi-imager". Then:

  • Connect an SD card reader with the SD card inside.

  • Open Raspberry Pi Imager and choose the Raspberry Pi OS Lite (64bit) from the list presented.

  • Choose the SD card you wish to write your image to.

  • After you have selected the operating system to install, a cog wheel will appear allowing you to open an "Advanced Options" menu.

  • Set Hostname as raspberry.local and Enable SSH(password authentication) and Configure Wifi(Optional) and configure User on the advanced options.

  • Review your selections and click on the Write button to begin writing data to the SD Card.

Post OS Installation¤

Connect the SD Card into the Raspberry PI 4 and assemble the pi inside its case and attach the heat sink and fan.

Connect the Raspbbery pi into the network using Ethernet(Recommended) or WiFi.

SSH into the pi using the raspberrypi.local hostname or the corresponding ip address of pi given by the Router/DHCP server.

Update and Upgrade the raspberry pi using the code below

sudo apt update && sudo apt upgrade -y

Installation of Docker and Portainer.¤

Run, to install docker, and add the current user to the docker usergroup.

wget -qO- | bash
You need to reboot/logout for changes to take effect.

Reboot for changes to take effect

sudo reboot

After a reboot, run, to install

wget -qO- | bash

Login to Portainer.¤

  • Goto raspberry_ip:9000 and then login.

  • Now just click App Templates and deploy applications!.

Update Portainer Script.¤

wget -qO- | bash

List of Documentation files.¤

List of all Documents used within this project.

File Name Description Install and setup instructions for Tailscale(A VPN Service) Install and setup instructions for Nginx Proxy Manager (NPM)
Self Signed SSL Certificate Follow these steps for SSL Certificate Authority for Local Https Development(can be used with NPM) Install and Setup Pi-Hole for Network-Wide Ad Block Install and Setup Vaultwarden, A privately hosted password manager Install and Setup Raspberry Pi & Docker Monitoring, A user-friendly way to monitor the performance of your Raspberry Pi Install and Setup Jellyfin, A Software to provide media from a dedicated server to end-user devices via multiple apps Install and Setup Filebrowser, A file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files Install and Setup Heimdall, Organise all those links to your most used web sites and web applications in a simple way. Install and Setup Qbittorrent, An open-source software alternative to µTorrent. Install and Setup sonarr, a PVR for usenet and bittorrent users. Install and Setup radarr, A fork of Sonarr to work with movies à la Couchpotato. Install and Setup jackett, translates queries from apps (Sonarr, SickRage, CouchPotato, Mylar, etc) into tracker-site-specific http queries, parses the html response, then sends results back to the requesting software. Install and Setup nextcloud, A safe home for all your data. Access & share your files, calendars, contacts, mail & more from any device, on your terms.
Z-Vote Install and Setup Z-Vote, A Blockchain based Voting System

Contact Me¤



GNU GPLv3 Image

Homelab is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.