https://github.com/yscialom/pinanas
Cloud services, safely hosted at home.
https://github.com/yscialom/pinanas
backup cloud homelab mediacenter nas-device raspberry-pi
Last synced: 7 days ago
JSON representation
Cloud services, safely hosted at home.
- Host: GitHub
- URL: https://github.com/yscialom/pinanas
- Owner: yscialom
- License: gpl-3.0
- Created: 2020-04-11T11:23:30.000Z (almost 6 years ago)
- Default Branch: develop
- Last Pushed: 2025-11-15T21:16:58.000Z (3 months ago)
- Last Synced: 2025-11-15T23:21:02.691Z (3 months ago)
- Topics: backup, cloud, homelab, mediacenter, nas-device, raspberry-pi
- Language: Jinja
- Homepage:
- Size: 4.61 MB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
PiNanas
========
**Cloud services, safely hosted at home.**
Description
-----------
PiNanas is a private cloud platform with a wild range of services included. It can be safely hosted at home or on any
privately-managed infrastructure. It is modular, flexible and open to extensions. Built with security and ease of use
in mind, PiNanas will empower you to transform any hardware (old computer, Raspberry Pi, ...) into a homelab and
private cloud.
Access your files from anywhere around the world. Never lose a photo anymore. Wonder no more how to play videos on
your TV.
### What can I do with PiNanas?
PiNanas includes:
- A private cloud platform:
- [Nextcloud](https://nextcloud.com "Nextcloud homepage"):
store, access and share your files, and more...
- [Immich](https://immich.app/ "Immich homepage"):
store and manage your photos and videos.
- [Jellyfin](https://jellyfin.org "Jellyfin homepage"):
manage and stream your films and tv shows.
- [Duplicati](https://www.duplicati.com/ "Duplicati homepage"):
store encrypted backups online.
- Network management:
- [AdGuard Home](https://adguard.com/en/adguard-home/overview.html "AdGuard Home homepage"):
protect your privacy and filter out advertising on all devices.
- Security and monitoring tools:
- [Traefik](https://traefik.io/traefik "Traefik homepage"):
simplify networking complexity while designing, deploying, and operating applications.
- [Authelia](https://www.authelia.com "Authelia homepage"):
rely on the Single Sign-On Multi-Factor portal for all PiNanas apps.
- [Netdata](https://www.netdata.cloud "Netdata homepage"):
monitor your infrastructure resources.
- Misc: [fail2ban](https://www.fail2ban.org) and
[logrotate](https://linux.die.net/man/8/logrotate "man logrotate").
[](https://github.com/yscialom/pinanas/actions/workflows/continuous-integration.yaml)
[](https://github.com/yscialom/pinanas/actions/workflows/continuous-deployment.yaml)
[](https://github.com/yscialom/pinanas/releases)
Installation
------------
### Requirements
#### Hardware
PiNanas will need a linux-based host, with:
- 32 GB free disk space
- 4 GB RAM, 8GB suggested
- An access to Internet
- Optionnally: a GPU suited to your needs (video transcoding & playing)
#### Software
During installation or operation, PiNanas requires:
- GNU utils
- docker and docker-compose
- a wildcard (sub)domain name (e.g. `*.home.example.com`); read
[How to get a domain name?](docs/get-a-domain-name.md "docs/get-a-domain-name.md") for more information.
Read [INSTALL](docs/INSTALL.md "docs/INSTALL.md") for a step-by-step guide on how to install PiNanas at home.
Contributing
------------
PiNanas is highly modular and can be extended. You can:
- [Link an external service to PiNanas](docs/external-services.md "docs/external-services.md") into its perimeter,
enhancing interoperability, security and visibility of applications.
- [Contribute](docs/CONTRIBUTING.md "docs/CONTRIBUTING.md") to this repository: feature request, bug
report, pull request...
Who are we?
-----------
PiNanas was born in 2020 during the Covid Pandemic when two friends discussed their frustrations around attempts to
setup Plex and their own private-cloud in a controlled environment, on low-cost hardware (Raspberry Pi 4).
It was around this time that [Techno Tim](https://www.technotim.live "Techno Tim homepage") published [a video on
Youtube](https://youtu.be/liV3c9m_OX8 "Put Wildcard Certificates and SSL on EVERYTHING - Traefik Tutorial") on how to
setup Traefik on a homelab, the first of a series on homelab services. These videos have been a continuous source of
inspiration for us. What we tinkered with became its own thing, and The Wife named it PiNanas: a
[NAS](https://en.wikipedia.org/wiki/Network-attached_storage "Network-attached storage") on a
[Pi](https://www.raspberrypi.org/ "Raspberry Pi")!
We'd be sincerly pleased to see you finding interest in our toy project.
— [Yankel Scialom](https://github.com/yscialom "YSC on Github") and
[glevil](https://github.com/glevil "glevil on Github").