Try SuperPlane on Your Computer
The fastest way to try SuperPlane is to run the latest version of the SuperPlane Docker container on your own machine. You’ll have a working SuperPlane instance in less than a minute, without provisioning any cloud infrastructure.
Prerequisites
Section titled “Prerequisites”To run SuperPlane, you need:
- Docker installed and running (for example Docker Desktop on macOS/Windows, or Docker Engine on Linux).
- A stable internet connection (SuperPlane opens a tunnel for incoming webhooks).
Starting SuperPlane
Section titled “Starting SuperPlane”Run the latest stable SuperPlane Docker container:
docker pull ghcr.io/superplanehq/superplane-demo:stabledocker run --rm -p 3000:3000 -v spdata:/app/data -ti ghcr.io/superplanehq/superplane-demo:stableThis pulls the stable image and starts SuperPlane in your terminal.
Public access and localtunnel
Section titled “Public access and localtunnel”SuperPlane needs to be reachable from the public internet to receive incoming webhooks. When you run the container, it automatically starts a localtunnel to expose your local instance through a public URL for incoming webhooks.
This is convenient for quick trials, but it also means:
- Your local SuperPlane instance becomes accessible from the internet via the tunnel URL.
- You should not use this setup with sensitive data, secrets, or production systems.
Use this setup for exploration and evaluation only. For more controlled, production-like deployments, use one of the single-host or Kubernetes installation options instead.
Try the beta channel
Section titled “Try the beta channel”To try the latest features before they land in stable, use the beta tag:
docker run -ti --rm ghcr.io/superplanehq/superplane-demo:betaBeta images may change more frequently and can be less stable than the
stable channel.
Pin a specific version
Section titled “Pin a specific version”If you want to run a particular version, you can pin it explicitly:
docker run -ti --rm ghcr.io/superplanehq/superplane-demo:v0.4Replace v0.4 with the version you want to run.
Updating SuperPlane
Section titled “Updating SuperPlane”To update to the latest version, run docker pull and restart the container:
docker pull ghcr.io/superplanehq/superplane-demo:stabledocker run --rm -p 3000:3000 -v spdata:/app/data -ti ghcr.io/superplanehq/superplane-demo:stableReplace stable with the specific version tag if needed.
Removing SuperPlane
Section titled “Removing SuperPlane”To completely remove SuperPlane, remove the data volume and Docker images:
docker volume rm spdatadocker rmi ghcr.io/superplanehq/superplane-demo:stableIf you’ve used other tags (like beta or specific versions), remove
those images as well:
docker rmi ghcr.io/superplanehq/superplane-demo:betadocker rmi ghcr.io/superplanehq/superplane-demo:v0.4