https://github.com/novaspirit/pi-hosted
Raspberry Pi Self Hosted Server Based on Docker / Portainer.io
https://github.com/novaspirit/pi-hosted
docker hacktoberfest homelab linux portainer raspberry-pi self-hosted server
Last synced: about 1 month ago
JSON representation
Raspberry Pi Self Hosted Server Based on Docker / Portainer.io
- Host: GitHub
- URL: https://github.com/novaspirit/pi-hosted
- Owner: novaspirit
- Created: 2021-09-16T15:21:14.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-03-18T19:55:30.000Z (about 2 months ago)
- Last Synced: 2025-04-05T08:01:36.503Z (about 1 month ago)
- Topics: docker, hacktoberfest, homelab, linux, portainer, raspberry-pi, self-hosted, server
- Language: Shell
- Homepage:
- Size: 16.6 MB
- Stars: 1,316
- Watchers: 40
- Forks: 380
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
Awesome Lists containing this project
README
# Pi-Hosted Portainer Template V2
[](https://discord.com/invite/v8dAnFV) [](https://www.youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw) [](https://twitter.com/novaspirittech)
This repository is a collection of tutorials for hosting a variety of server applications using [Docker](https://www.docker.com/) and [Portainer](https://github.com/portainer/portainer).
### App Template for Portainer
### Apps List
See the list of apps included in this template [here](https://github.com/pi-hosted/pi-hosted/blob/master/docs/AppList.md).
### 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
| 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 |
Portainer V2.22 or higher
| Architecture | Tested OS's | URL |
| ------------ | ----------- | --- |
| Arm64 | Pi OS, Ubuntu, DietPi | https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/template/portainer-v3-arm64.json |
| Amd64 | Ubuntu, Debian | https://raw.githubusercontent.com/pi-hosted/pi-hosted/master/template/portainer-v3-amd64.json |
* 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
[](https://www.youtube.com/watch?v=cO2-gQ09Jj0&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc)
| | Channel | Episode | Additional Information |
|:---:|:-------:|---------|------------------------|
|N.01|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Raspberry Pi 4 Server Setup, Docker Install, Portainer Install, Shell In A Box](https://www.youtube.com/watch?v=cO2-gQ09Jj0&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=1)||
|N.02|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Installing and Configuring Homer Dashboard](https://www.youtube.com/watch?v=_d3J88ootYo&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=2)||
|N.03|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Manually Installing Guacamole on Portainer](https://www.youtube.com/watch?v=cKAhnf8X1lo&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=3)||
|N.04|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Installing JDownloader and File Browser On The Pi Docker Server](https://www.youtube.com/watch?v=30MYRgCObu8&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=4)||
|N.05|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Torrent with Docker and OPENVPN with Transmission and PIA](https://www.youtube.com/watch?v=tGLVEq913_4&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=5)||
|N.Extra1|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Portainer.io App Template for Raspberry Pi arm/arm64 I Need Your Help!](https://www.youtube.com/watch?v=Zn-VELlaIN4&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=6)||
|N.06|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Upgrading Portainer and Updating Containers](https://www.youtube.com/watch?v=q3wKqk8qVS8&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=7)||
|N.07|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Raspberry Pi Docker Monitoring](https://www.youtube.com/watch?v=IoD3vFuep64&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=8)|[Install Doc](../docs/rpi_docker_monitor.md)|
|N.08|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Installing Nextcloud on Raspberry Pi Docker](https://www.youtube.com/watch?v=E6IrT3g5Gqc&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=9)||
|N.09|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Installing Nginx Proxy Manager on Docker](https://www.youtube.com/watch?v=yl2Laxbqvo8&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=10)|[Install Doc](../docs/nginx_proxy_manager.md)|
|N.10|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Setting up Raspberry Pi Samba Server For File Sharing on Docker](https://www.youtube.com/watch?v=2zZ3_1GRWrM&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=11)||
|N.11|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[How to Install Whoogle to replace using Google and repo notes](https://www.youtube.com/watch?v=j3ZGxo3ibUs&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=12)||
|N.12|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Checking out Windows 2000 Docker](https://www.youtube.com/watch?v=57Gnp0424Qc&list=PL846hFPMqg3jwkxcScD1xw2bKXrJVvarc&index=13)||
|N.Extra2|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[3 Huge Announcements!! Discord Giveaway! Pi-Hosted!! & SBC Garage Sale!](https://www.youtube.com/watch?v=Ppv1cUomwn0)||
|N.13|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Beginners Guide to WireGuard Docker and Installing Pi-OS 64bit](https://www.youtube.com/watch?v=yB_jAumIxOg)|[Install Doc](../docs/wireguard-install.md)|
|N.14|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[My Most used container! Snippet Box](https://www.youtube.com/watch?v=v-jUyB3fvAo)||
|N.15|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Rust Desk Open Source Remote Desktop](https://www.youtube.com/watch?v=PDnqFnnbVHg)||
|N.16|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Route Docker Traffic Through VPN Container](https://www.youtube.com/watch?v=IWj1-j2QWvo)||
|N.17|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Building NAS with Container](https://www.youtube.com/watch?v=9ln6UFH4z8o)||
|N.18|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Reviewing Stats on 25+ containers on my Raspberry Pi](https://www.youtube.com/watch?v=_tVj0FX5wYg)||
|N.Extra3|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Biggest Update to Pi-Hosted Portainer.io Template!](https://www.youtube.com/watch?v=7R7l6c3wswQ)||
|N.Extra4|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Run Android In Docker with this Container!](https://www.youtube.com/watch?v=GTtdTksS6L0)||
|N.19|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Control Multiple Dockers From One Location with Portainer Agent](https://www.youtube.com/watch?v=OC-SVcHnm74)||
|N.20|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Your Personal Weather Station Docker Container](https://www.youtube.com/watch?v=5JfPzvcm0E8)||
|N.21|[](https://youtube.com/channel/UCrjKdwxaQMSV_NDywgKXVmw)|[Hosting Without The Need to Port Forward Using This Trick!](https://www.youtube.com/watch?v=-QGbfTY5ExE)||
### Aditional Documentation
You can find more tutorials and useful information in our [GitHub Docs](https://github.com/pi-hosted/pi-hosted/blob/master/docs/DocumentList.md) folder.
### Included Scripts
Install, Update, Pre-Install and extra scripts can be found in our [GitHub Tools](https://github.com/pi-hosted/pi-hosted/blob/master/tools) folder.
### Contributors
See the list of [contributors](https://github.com/pi-hosted/pi-hosted/graphs/contributors) who participated in this project.
### Acknowledgment
* template based on [SelfHosted](https://github.com/SelfhostedPro/selfhosted_templates) Portainer App Template branch on 2021/10/05