Skip to content
Stackpad Docs

Quickstart

This guide walks you through deploying your first application on Stackpad. By the end, you’ll have a live app running on European infrastructure.

Prerequisites

  • A GitHub account
  • A project you want to deploy (or use one of our templates)

Deploy your first app

  1. Create your Stackpad account

    Go to app.stackpad.eu and sign up with your GitHub account or email. You’ll be prompted to create an organization — this is your team workspace.

  2. Create a new project

    From the dashboard, click New Project. Give it a name — this will be used in your default URL (your-project.your-org.stackpad.eu).

  3. Add a web service

    Click Add Service and select From GitHub. Stackpad will list your GitHub repositories. Select the repo you want to deploy.

    Pick the branch to deploy from (usually main) and Stackpad will automatically detect your framework.

  4. Configure and deploy

    Review the detected settings:

    • Framework: Auto-detected (Next.js, Remix, Astro, etc.)
    • Build command: Pre-filled based on your framework
    • Port: Pre-filled based on your framework

    Add any environment variables your app needs, then click Deploy.

  5. Your app is live

    Stackpad builds your app, starts the container, runs a health check, and routes traffic to it. Your app is now live at:

    https://your-project.your-org.stackpad.eu

    Future deployments happen automatically — just push to your branch.

Add a database

Most apps need a database. Here’s how to add PostgreSQL to your project:

  1. In your project, click Add Service and select Database.

  2. Choose PostgreSQL and click Create.

  3. Stackpad creates the database and automatically injects the connection string into your web service as DATABASE_URL.

  4. Your web app can now connect to PostgreSQL at postgres:5432 on the private network — no configuration needed.

What’s next?