Repolode
shpyrd-io

shpyrd-io/shpyrd

Open-source PaaS that runs on Kubernetes, covering cluster bootstrap, builds, releases, TLS URLs, config, logs and metrics from one CLI and dashboard.

Open-source alternative to:HerokuFly.io

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. 1

    Install the CLI with Homebrew (macOS)

    brew install shpyrd-io/tap/shpyrd
  2. 2

    Create the local kind cluster and base stack (10-20 minutes the first time)

    shpyrd cluster create
  3. 3

    Trust the development CA (asks for sudo)

    shpyrd cluster trust-ca
  4. 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