Getting Started

Podway lets you deploy any Dockerized application to Kubernetes without managing infrastructure. Follow these steps to deploy your first app.

1. Create your first project

Projects group your apps together. Click New project on the Projects page, give it a name, and click Create.

2. Add registry credentials

Podway needs credentials to push your Docker images to a container registry.

  1. Go to Registry Credentials in the sidebar
  2. Click Connect next to GitHub Container Registry (GHCR)
  3. Enter your GitHub username
  4. Create a Personal Access Token at github.com/settings/tokens with the write:packages scope
  5. Paste the token and click Save

3. Create an app

Inside your project, create an app for each service you want to deploy.

  1. Open your project
  2. Click New app
  3. Choose Blank app or From template
  4. Give your app a name and click Create

4. Connect a GitHub repository

Link your app to a GitHub repo so Podway can clone and build your code.

  1. Open your app’s detail page
  2. Click Connect repository
  3. Install the Podway GitHub App when prompted — select which repositories to grant access to
  4. Select your repository from the list

5. Create an environment

Add environments like production or staging inside your app.

  1. Inside your app, click New environment
  2. Name it (e.g. production)
  3. Click Create

6. Trigger your first build

Go to your app’s Builds tab and trigger a build from a commit SHA.

  1. Click Trigger build
  2. Enter the commit SHA and branch
  3. Click Build
  4. Watch the build logs stream in real time

7. Deploy your app

Once a build succeeds, deploy it to an environment.

  1. Click Deploy on the successful build
  2. Select the environment
  3. Click Deploy

Your app will be live at https://{app-slug}-{env-name}.podway.dev once the deployment is active.