Crash Course

On this page

Buckle up, it’s time to learn the basics of deploying on Stackblaze in less than 5 minutes.

Here’s what you’ll need:

  1. A Stackblaze account
  2. A Github account with admin permissions
  3. A motivational song to play while following these steps

Buckle up, it's Stackblaze time

Complete the Onboarding

Head over to the Stackblaze platform, create an account and complete the onboarding. The platform will guide you through:

  1. Setting up your account
  2. Creating a project

Stackblaze onboarding

Connecting a Repository

Stackblaze requires your code to live in a Git repository. When you first attempt to create an Application you’ll be prompted to connect Github.
We currently support Github. If you use another provider, drop us a comment below.

Stackblaze Github Connection

The Checklist

Regardless of the language you are deploying, there are a few things you need check before deploying on Stackblaze.

1. Check the supported scenarios

Make sure what you’re deploying will work by checking our list of supported scenarios

2. Listen to the right port

Stackblaze routes traffic to your app using the PORT environment variable. Your app should listen to this port.

3. Set your environment variables

If your app needs certain environment variables to run, set them up before you deploy. Otherwise your app will crash on startup.

4. Supply a Dockerfile (optional)

Stackblaze recommends using a Dockerfile for most control. See our Dockerfile quickstart for more information.
If you don’t want to use a Dockerfile, make sure you’ve set up your codebase so Stackblaze knows how to build it. See our quickstart guides for more information.

Deploy!

Select one of your existing repos or use one of our templates and watch Stackblaze build and deploy it. Logs appear in realtime.

Deploying a repository

Troubleshooting Failures

If your deployment fails, don’t stress! Stackblaze provides detailed logs to help you determine the cause.

  1. Check the Setup, build and deploy logs for any errors
  2. If your app failed at the Deploy stage, check the Application Logs for any errors produced by your application on startup
  3. If you’re still stuck, ask Stackblazebot! Stackblazebot is our AI helper and can provide troubleshooting advice

Be sure to double-check the checklist on this page. Read more on the troubleshooting deployments page.

Log sidebar

Using Your Application

Once you have a successful deployment, you’ll see a unique URL in the summary of your application. Use that to access your site or API.

Your unique Stackblaze URL

Wrapping Up

Nice work! You made it through the crash course on Stackblaze. Be sure to check out our other tutorials to get started with your specific language!

The Stackblaze crash course