Featured
Deploy your first app from GitHub
Connect GitHub in the dashboard, pick a repo, review the build method, and commit the app on the phase canvas.
5 min read
Read guide
Guides
Learn by doing. Ship faster.
Dashboard steps for GitHub deploys, add-ons, domains, and stackblaze.yaml — written against the product as it ships today.
Connect a GitHub repository
Install the GitHub App, pick a repo, and review the detected build method in the dashboard.
3 minRead
Set up environment variables
Add variables on the app Variables tab, or drop in a .env file. Each app has its own set.
4 minRead
Apps and managed add-ons
Web apps, workers, scheduled jobs on an app, and managed add-ons on the phase canvas.
6 minRead
Provision a PostgreSQL database
Add a Postgres add-on from + Service → Databases. Connection values are injected on the app.
5 minRead
Set up a Valkey cache
Add Valkey (Redis-compatible) from Databases. REDIS_URL and REDISHOST are injected on the app.
4 minRead
Point-in-time database recovery
On the add-on Backups tab, restore Latest, Point in time, or a named backup into a new instance.
7 minRead
Migrate from Heroku
Connect the same GitHub repo, import a .env file, add Postgres or Valkey, then point DNS.
10 minRead
Define a project with stackblaze.yaml
Export or import stackblaze.yaml. Enable IaC apply on the project. Apply never deletes.
8 minRead
Add a custom domain
Add a custom domain on the app, create the CNAME and TXT records, then wait for HTTPS.
5 minRead
Private networking between services
Apps and add-ons in the same phase share a private network. Connection strings are injected.
4 minRead
WebSockets on StackBlaze
WebSockets work on the public HTTPS URL. There is no sticky-sessions toggle in the dashboard.
5 minRead
Horizontal scaling and autoscaling
On Scale, set web and worker replica counts or turn on autoscaling with min and max pods.
8 minRead
Zero-downtime deployments
New revisions roll out while the previous ones stay up. Set a health-check path on Runtime.
6 minRead
Enable two-factor authentication
Enable TOTP in account settings. There are no recovery codes — keep the authenticator app.
3 minRead
Invite members and assign roles
From Settings → Members, invite with admin, member, or guest. Invites expire in 7 days.
5 minRead
Automatic deploy on push
Turn on Autodeploy on the app. A push to the connected branch builds and rolls out a new revision.
4 minRead
PR preview environments
Enable Preview environments on the project. PR apps are named pr-<number>-<source-app>.
5 minRead
Redeploy from git or the dashboard
There is no deploy-hook URL. Use Autodeploy on push, Redeploy in Deployments, or Restart.
4 minRead
One-click rollbacks
Open Deployments and use Instant Rollback or Rollback Config. There is no rollback CLI.
3 minRead
Deploy with a Dockerfile
Set Build method to Docker, confirm the Dockerfile path and Port, then deploy from GitHub.
5 minRead
Using Docker Compose locally, deploying to StackBlaze
Import docker-compose from + Service → Import, or map apps and add-ons by hand on the canvas.
7 minRead
Attach a persistent disk
On Storage, add a volume with a name, size, and mount path. Replicas share the same volume.
4 minRead
Configure health checks
On Runtime, enable Health Checks and set the path, startup, timeout, and interval.
4 minRead
Schedule cron jobs
On the app Jobs tab, add a scheduled task with a five-field cron expression.
4 minRead
Monorepo deployments
Detection can seed multiple apps from one repo. Set Build path per app, relative to the root.
6 minRead