Skip to content

Quick Start

deploybase deploys static sites to European infrastructure. This guide covers account creation through first production deployment.

  • A deploybase account at app.deploybase.eu
  • A static site in a Git repository (GitHub, GitLab, Bitbucket, or Codeberg)

From the dashboard, click New Project. Provide:

FieldRequiredDescription
NameYesDisplay name (e.g. My Blog)
SlugAutoURL-safe identifier, used in {slug}.sites.deploybase.eu
FrameworkNoAuto-detected from repo. Options: nextjs, sveltekit, astro, hugo, vite, gatsby, jekyll, other
Git Repository URLNoHTTPS clone URL (e.g. https://github.com/user/repo.git)
Git ProviderNogithub, gitlab, bitbucket, or codeberg
Default BranchNoBranch that auto-promotes to production. Defaults to main

API equivalent:

Terminal window
curl -X POST https://api.deploybase.eu/api/v1/projects \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "My Blog", "framework": "astro", "git_repo_url": "https://github.com/user/blog.git", "git_provider": "github"}'

After creating the project, deploy from a branch:

Terminal window
curl -X POST https://api.deploybase.eu/api/v1/deployments \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"project_id": "PROJECT_ID", "branch": "main"}'

The build runs asynchronously. Poll the deployment status:

Terminal window
curl https://api.deploybase.eu/api/v1/deployments/DEPLOYMENT_ID \
-H "Authorization: Bearer $TOKEN"

Status progression: pendingqueuedbuildingdeployed (or failed).

Once status is deployed, your site is live at:

https://{slug}.sites.deploybase.eu

Default branch deployments auto-promote to production. Non-default branches create preview deployments.