Pi-Hosted is a collection of tutorials for hosting a variety of server applications using Docker and Portainer on the Raspberry Pi.

View on GitHub

Pi-Hosted Portainer Template V2

Discord Youtube Twitter URL

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

App Template for Portainer

App Template Image

Apps List

See the list of apps included in this template here.


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

wget -qO- https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/install_docker.sh | bash

You need to reboot/logout for changes to take effect

Pi OS Buster

On Oct 30, 2021 Pi OS bullseye was released and this is no longer needed. Older Pi OS buster releases run an old version of libseccomp that is causing problems with many containers that are preventing them from running. To fix this we need to manually install a newer version of libseccomp. However we first need to check and see if you are running an older version. To check please run sudo dpkg-query -W libseccomp.

sudo dpkg-query -W libseccomp2

If you are running a version less that 2.5 you will need to run the upgrade script.

wget -qO- https://raw.githubusercontent.com/pi-hosted/pi-hosted/master//tools/update_libseccomp2.sh | bash

Reboot for changes to take effect

sudo reboot

After a reboot, run install-portainer.sh, to install Portainer.io

wget -qO- https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/install_portainer.sh | bash
# to update portainer, run this command instead
wget -qO- https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/update_portainer.sh | bash

Login to Portainer to update the App Template.

Goto pi-ip:9000 and then login

Click Settings, in the bottom-left corner, and paste the Portainer v2 json file link from below into the “App Templates” box.

You’re done! Now just click App Templates and deploy applications!

Portainer Architecture

Architecture Tested OS’s URL
Arm32 Pi OS, DietPi https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/template/portainer-v2-arm32.json
Arm64 Pi OS, Ubuntu, DietPi https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/template/portainer-v2-arm64.json
Amd64 Ubuntu, Debian https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/template/portainer-v2-amd64.json

Pi-Hosted YouTube series

Pi-Hosted Playlist

  Channel Episode Additional Information
N.01 Novaspirit Tech Raspberry Pi 4 Server Setup, Docker Install, Portainer Install, Shell In A Box  
N.02 Novaspirit Tech Installing and Configuring Homer Dashboard  
N.03 Novaspirit Tech Manually Installing Guacamole on Portainer  
N.04 Novaspirit Tech Installing JDownloader and File Browser On The Pi Docker Server  
N.05 Novaspirit Tech Torrent with Docker and OPENVPN with Transmission and PIA  
N.Extra1 Novaspirit Tech Portainer.io App Template for Raspberry Pi arm/arm64 I Need Your Help!  
N.06 Novaspirit Tech Upgrading Portainer and Updating Containers  
N.07 Novaspirit Tech Raspberry Pi Docker Monitoring Install Doc
N.08 Novaspirit Tech Installing Nextcloud on Raspberry Pi Docker  
N.09 Novaspirit Tech Installing Nginx Proxy Manager on Docker Install Doc
N.10 Novaspirit Tech Setting up Raspberry Pi Samba Server For File Sharing on Docker  
N.11 Novaspirit Tech How to Install Whoogle to replace using Google and repo notes  
N.12 Novaspirit Tech Checking out Windows 2000 Docker  
N.Extra2 Novaspirit Tech 3 Huge Announcements!! Discord Giveaway! Pi-Hosted!! & SBC Garage Sale!  
N.13 Novaspirit Tech Beginners Guide to WireGuard Docker and Installing Pi-OS 64bit Install Doc
N.14 Novaspirit Tech My Most used container! Snippet Box  
N.15 Novaspirit Tech Rust Desk Open Source Remote Desktop  
N.16 Novaspirit Tech Route Docker Traffic Through VPN Container  
N.17 Novaspirit Tech Building NAS with Container  
N.18 Novaspirit Tech Reviewing Stats on 25+ containers on my Raspberry Pi  
N.Extra3 Novaspirit Tech Biggest Update to Pi-Hosted Portainer.io Template!  
N.Extra4 Novaspirit Tech Run Android In Docker with this Container!  
N.19 Novaspirit Tech Control Multiple Dockers From One Location with Portainer Agent  
N.20 Novaspirit Tech Your Personal Weather Station Docker Container  
N.21 Novaspirit Tech Hosting Without The Need to Port Forward Using This Trick!  

Aditional Documentation

You can find more tutorials and useful information in our GitHub Docs folder.

Included Scripts

Install, Update, Pre-Install and extra scripts can be found in our GitHub Tools folder.


See the list of contributors who participated in this project.