novaspirit/pi-hosted

Raspberry Pi Self Hosted Server Based on Docker / Portainer.io

Shell

1,413

1,229 commits

updated Aug 4, 2025

See the code

README

Pi-Hosted Portainer Template V2 & V3

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.

Installation

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
  • The upgrade script is for Pi OS 32bit. Pi OS 64 beta is untested and the upgrade script wont work with it.

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

This does not work for ARM32 based systems. See below.

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

Portainer V2.21 or lower

Portainer V2.22 or higher

  • Amd64 should work on all distros with scripts written for Debian based distros

ARM32 support

ARM32 support is slowly getting dropped, we recommend you upgrade to ARM64 as soon as possible

The above script to install Portainer doesn't work, as the portainer/portainer-ce:latest Docker image doesn't support ARM32 any more. You can run the commands in the script directly and use portainer/portainer-cs:linux-arm-2.11.1-alpine instead.

Pi-Hosted YouTube series

Pi-Hosted Playlist

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.

Contributors

See the list of contributors who participated in this project.

Acknowledgment

  • template based on SelfHosted Portainer App Template branch on 2021/10/05
docker
hacktoberfest
homelab
linux
portainer
raspberry-pi
self-hosted
server

novaspirit/pi-hosted

Raspberry Pi Self Hosted Server Based on Docker / Portainer.io

Shell

1,413

1,229 commits

updated Aug 4, 2025

See the code

README

Pi-Hosted Portainer Template V2 & V3

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.

Installation

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
  • The upgrade script is for Pi OS 32bit. Pi OS 64 beta is untested and the upgrade script wont work with it.

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

This does not work for ARM32 based systems. See below.

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

Portainer V2.21 or lower

Portainer V2.22 or higher

  • Amd64 should work on all distros with scripts written for Debian based distros

ARM32 support

ARM32 support is slowly getting dropped, we recommend you upgrade to ARM64 as soon as possible

The above script to install Portainer doesn't work, as the portainer/portainer-ce:latest Docker image doesn't support ARM32 any more. You can run the commands in the script directly and use portainer/portainer-cs:linux-arm-2.11.1-alpine instead.

Pi-Hosted YouTube series

Pi-Hosted Playlist

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.

Contributors

See the list of contributors who participated in this project.

Acknowledgment

  • template based on SelfHosted Portainer App Template branch on 2021/10/05
docker
hacktoberfest
homelab
linux
portainer
raspberry-pi
self-hosted
server

Significant stargazers

Aindriú Mac Giolla Eoin

44 followers · starred Dec 2022

Richard Kuhnt

132 followers · starred Oct 2021

Matt Travi

259 followers · starred Nov 2025

FineFindus

138 followers · starred Aug 2025