Skip to main content

Try free on Pangolin Cloud

Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
The Pangolin Community Blueprints repository is a shared library of ready-to-use Docker Compose templates for common self-hosted services, already wired to expose those services through Pangolin.

View the repository on GitHub to browse the available blueprints and learn more: github.com/fosrl/blueprints

​
Why this repository exists

When people self-host, the hardest part is often not the app itself, it is the networking, exposure, and access control around it. This repository exists to package those patterns into reusable blueprints so you can:
  • start from known-good templates for popular services
  • avoid repetitive reverse proxy and exposure configuration
  • apply secure defaults like SSO-oriented access patterns
  • make deployments more consistent across environments
  • share and improve blueprints as a community

​
What you get

Each service blueprint includes pre-defined labels and structure that map to Pangolin resources, so bringing a service up can create and configure its exposure model with minimal dashboard work. Common examples include:
  • Grafana
  • Homepage
  • Immich
  • Jellyfin
  • and more community-contributed services
Browse the full, current list in the repository:

​
Quick start

At a high level, getting started looks like this:
  1. Create a Pangolin Cloud account (or use your self-hosted Pangolin) and set up a site.
  2. Copy your site connector values (NEWT_ID and NEWT_SECRET) and set your base domain.
  3. Clone the community blueprints repository and configure the root .env.
  4. Initialize and run a service blueprint.
git clone https://github.com/fosrl/blueprints
cd blueprints
./bin/blueprint list
./bin/blueprint init <service>
./bin/blueprint up <service>
For complete setup details and all command options, use the repository docs directly:

​
Contribute and learn more

The repository is community-driven. If a service you use is missing, you can propose or contribute a blueprint.