Deploy a SvelteKit application

​

At a glance

​

Environment variables

​

Before you begin

• A Sevalla company with a payment method, and a GitHub, GitLab or Bitbucket account for the repository. See Git providers.
• Node.js 24 or later on your computer.

​

Create the project

npx sv create storefront --template minimal --types ts --add sveltekit-adapter="adapter:node" --install npm
cd storefront

import adapter from "@sveltejs/adapter-node";
import { sveltekit } from "@sveltejs/kit/vite";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [
    sveltekit({
      adapter: adapter(),
    }),
  ],
});

​

Prepare the project for Sevalla

npm pkg set engines.node="24.x"

• It takes its port from PORT, which Sevalla sets to the web process’s port (8080 by default), and listens on 0.0.0.0, all network interfaces.
• It builds URLs from the request’s Host header and assumes HTTPS, which matches how requests reach the application through Sevalla, so form actions pass SvelteKit’s origin check without PROTOCOL_HEADER or HOST_HEADER.

git init
git add .
git commit -m "Prepare for Sevalla"
git branch -M main
git remote add origin https://github.com/acme/storefront.git
git push -u origin main

​

Deploy to Sevalla

​

Verify the deployment

1. On the Deployments tab, click the deployment. Its Build log shows Ingot’s build plan: Node.js 24 from engines.node, npm from package-lock.json, SvelteKit with the Node.js adapter from package.json, and node build as the start command.
   Build log

   ╭─ ■ SvelteKit (Node adapter) · Node.js 24 ──────────────────────────────╮
   │ Node.js          24                        package.json engines "24.x" │
   │ Package manager  npm                       package-lock.json           │
   │ Framework        SvelteKit (Node adapter)  package.json                │
   │ Start            node build                SvelteKit (Node adapter)    │
   │ DevDependencies  removed after the build                               │
   ├─ Image ────────────────────────────────────────────────────────────────┤
   │ Build            node:24-trixie                                        │
   │ Runtime          node:24-trixie-slim                                   │
   │ User             1000:1000                                             │
   │ Init             tini                                                  │
   │ Port             $PORT, default 8080                                   │
   ╰───────────────────────────────────────────────────────── Ingot v0.5.0 ─╯
   
2. Wait for the deployment’s status to change to Deployed. The application’s status next to its name changes to Running.
3. Click the domain under the application’s name, for example storefront-x7k2m.sevalla.app. The page shows Welcome to SvelteKit.

curl -s https://storefront-x7k2m.sevalla.app/ | grep -o 'Welcome to SvelteKit'

Welcome to SvelteKit

​

Deploy changes

​

Use environment variables

​

Deploy with a Dockerfile

FROM node:24-trixie AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build && npm prune --omit=dev

FROM node:24-trixie-slim
WORKDIR /app
ENV NODE_ENV=production PORT=8080
COPY package.json ./
COPY --from=build /app/node_modules ./node_modules
COPY --from=build /app/build ./build
USER 1000:1000
EXPOSE 8080
CMD ["node", "build"]

.git
.svelte-kit
build
node_modules
.env*
*.log
Dockerfile
.dockerignore

​

Add a custom domain

​

Connect a database

​

Deploy with the API

• An API key with the Company developer role, or the APP:CREATE, APP:READ and APP:UPDATE permissions, in the SEVALLA_API_KEY environment variable. The CLI reads the key from SEVALLA_API_TOKEN.
• The repository on GitHub, GitLab or Bitbucket, and a Git account that can read it connected to your Sevalla user, which only the dashboard can do. See Git providers. Creating the application checks the access: if Sevalla can’t read the repository, the call returns 400 with Cannot access repository https://github.com/acme/storefront: Repository not found or you don't have access., followed by where to grant the access.
• curl and jq.

CLUSTER_ID=$(curl -s https://api.sevalla.com/v3/resources/clusters \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  | jq -r '.[] | select(.location == "eu-frankfurt-1") | .id')

APP_ID=$(curl -s -X POST https://api.sevalla.com/v3/applications \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<EOF | jq -r .id
{
  "display_name": "storefront",
  "cluster_id": "$CLUSTER_ID",
  "source": "privateGit",
  "git_type": "github",
  "repo_url": "https://github.com/acme/storefront",
  "default_branch": "main"
}
EOF
)

WEB_ID=$(curl -s "https://api.sevalla.com/v3/applications/$APP_ID/processes" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  | jq -r '.data[] | select(.type == "web") | .id')

H1_ID=$(curl -s https://api.sevalla.com/v3/resources/process-resource-types \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  | jq -r '.[] | select(.name == "h1") | .id')

curl -s -X PATCH "https://api.sevalla.com/v3/applications/$APP_ID/processes/$WEB_ID" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"resource_type_id\":\"$H1_ID\"}" \
  | jq -r .resource_type_name

h1

curl -s -X PATCH "https://api.sevalla.com/v3/applications/$APP_ID" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auto_deploy":true}' \
  | jq -r .auto_deploy

true

curl -s -X PATCH "https://api.sevalla.com/v3/applications/$APP_ID" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"build_type":"dockerfile","dockerfile_path":"Dockerfile","docker_context":"."}' \
  | jq -r .build_type

dockerfile

DEPLOYMENT_ID=$(curl -s -X POST "https://api.sevalla.com/v3/applications/$APP_ID/deployments" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  | jq -r .id)

for i in $(seq 1 120); do
  STATUS=$(curl -s "https://api.sevalla.com/v3/applications/$APP_ID/deployments/$DEPLOYMENT_ID" \
    -H "Authorization: Bearer $SEVALLA_API_KEY" | jq -r '.status // empty')
  case $STATUS in success|failed|cancelled|skipped) break ;; esac
  sleep 15
done
echo "$STATUS"

success

curl -s "https://api.sevalla.com/v3/applications/$APP_ID/deployments/$DEPLOYMENT_ID/logs?limit=5000" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  | jq -r '.[].message' | grep '│ Start' | tr -s ' '

│ Start node build SvelteKit (Node adapter) │

DOMAIN=$(curl -s "https://api.sevalla.com/v3/applications/$APP_ID/domains" \
  -H "Authorization: Bearer $SEVALLA_API_KEY" \
  | jq -r '.data[] | select(.is_primary) | .name')
curl -s "https://$DOMAIN/" | grep -o 'Welcome to SvelteKit'

Welcome to SvelteKit