Self-hostable platform to deploy apps, databases and one-click services to your own servers over SSH, an alternative to Heroku, Netlify and Vercel.
- Stars
- 165
- Forks
- 0
- Open issues
- 30
- Last commit
- 5 hours ago
What is it?
shpyrd is an open-source platform-as-a-service that runs on Kubernetes. It handles the whole path from bootstrapping a cluster to deploying applications: buildpack and Dockerfile builds, releases and rollbacks, URLs with TLS, config vars, logs and metrics, all managed through one CLI and one web dashboard.
The CLI can create a local kind cluster with a base stack that includes cert-manager, ingress-nginx, kpack, kube-prometheus-stack and a PostgreSQL control-plane database. Applications are deployed from a local directory or a Git repository, and the platform builds them in-cluster. Databases (CloudNativePG PostgreSQL), Valkey/Redis caches and persistent volumes can be attached to apps as extensions.
The project is in beta and runs on local kind clusters and Oracle Cloud (OKE). It includes team and role-based access control, API tokens, per-project network policies, log drains and nightly platform backups on cloud profiles.
Key features
- 01Builds apps with buildpacks or Dockerfiles inside the cluster, with releases and rollbacks.
- 02Creates a local kind cluster and installs a base stack in ordered runlevels.
- 03Provides URLs with TLS via cert-manager and ingress-nginx.
- 04Attaches PostgreSQL, Redis-compatible caches and persistent volumes to apps.
- 05Offers a CLI and web dashboard showing metrics, build logs and per-instance logs.
- 06Supports team roles, API tokens and per-project network policies.
Use cases
- Running a self-hosted Heroku-style platform on your own Kubernetes or Oracle Cloud cluster.
- Deploying Go, Node, Java, Python or Dockerfile-based services with TLS and config vars from one CLI.
- Giving a team a shared dashboard for app metrics, logs and rollbacks.
- Experimenting with a local Kubernetes-based PaaS on macOS or Linux using Docker.
Quick start
- 1
Install the CLI with Homebrew (macOS)
brew install shpyrd-io/tap/shpyrd - 2
Create the local kind cluster and base stack (10-20 minutes the first time)
shpyrd cluster create - 3
Trust the development CA (asks for sudo)
shpyrd cluster trust-ca - 4
Open the dashboard signed in
shpyrd cluster dashboard
Things to know
- Status is beta.
- It needs Docker, with 6-8 GB of memory for Docker Desktop, and runs on macOS or Linux.
- The README only documents local kind clusters and Oracle Cloud (OKE) as supported targets.
Topics
FAQ
- What is shpyrd?
- Open-source PaaS that runs on Kubernetes, covering cluster bootstrap, builds, releases, TLS URLs, config, logs and metrics from one CLI and dashboard. shpyrd is an open-source platform-as-a-service that runs on Kubernetes. It handles the whole path from bootstrapping a cluster to deploying applications: buildpack and Dockerfile builds, releases and rollbacks, URLs with TLS, config vars, logs and metrics, all managed through one CLI and one web dashboard.
- Is shpyrd free to use? What license does it have?
- shpyrd is open source under the MPL-2.0 license. Check the license terms before using it in commercial products.
- Is shpyrd still maintained?
- Actively maintained. The last commit to shpyrd was on Oct 21, 2026.
- What can I use shpyrd for?
- Running a self-hosted Heroku-style platform on your own Kubernetes or Oracle Cloud cluster. Deploying Go, Node, Java, Python or Dockerfile-based services with TLS and config vars from one CLI. Giving a team a shared dashboard for app metrics, logs and rollbacks. Experimenting with a local Kubernetes-based PaaS on macOS or Linux using Docker.
- How do I install shpyrd?
- Install the CLI with Homebrew (macOS): brew install shpyrd-io/tap/shpyrd Create the local kind cluster and base stack (10-20 minutes the first time): shpyrd cluster create Trust the development CA (asks for sudo): shpyrd cluster trust-ca Open the dashboard signed in: shpyrd cluster dashboard
- Where can I get shpyrd?
- The source code and installation instructions are on GitHub: https://github.com/shpyrd-io/shpyrd
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hostable PaaS for deploying apps and databases on your own VPS, as an alternative to Vercel, Netlify and Heroku.
A self-hosted, Docker-powered mini-Heroku that deploys and manages web apps on your own server from a git push.
A self-hosted continuous delivery and deployment platform for containerized apps, with version management across Docker, Podman and Kubernetes.
Open source system for deploying, scaling and managing containerized applications across multiple hosts.
Helm is the package manager for Kubernetes, installing and managing apps packaged as reusable Charts.