Squadbase
Squadbase Docs

squadbase.yml

Learn how to configure `squadbase.yml`.

Squadbase uses a YAML-formatted file to describe how your app should be built and which cloud settings to apply at deploy time.
By defining these parameters, the platform picks up the settings automatically during deployment.

The file is usually saved as squadbase.yml, but you can rename it by changing Setting file path in the dashboard.
Required keys vary depending on the runtime and framework you choose.

version: '1'
 
# Build Settings
build:
  framework: streamlit        # streamlit | nextjs | morph
  runtime: python3.9          # python3.9, python3.10, python3.11, python3.12, node18, node20, node22
  package_manager: pip        # pip, poetry, uv, npm, yarn, pnpm
  entrypoint: src/app.py      # src/app.py
  # Custom Dockerfile settings
  context: .
  build_args:
    ARG1: value1
    ARG2: value2
 
# Deployment Settings
deployment:
  provider: gcp
  aws:
    memory: 512
    timeout: 30
    provisioned_concurrency: 0
    ephemeral_storage: 512
  gcp:
    memory: 1Gi
    cpu: 1
    timeout: 300
    concurrency: 80
    min_instances: 0
    ephemeral_storage: 10Gi

Build

Define build-time settings under build:.

Squadbase builds your app with Docker. For frameworks listed in framework, you don’t need to write your own Dockerfile—one is provided automatically.
If you’re using an unsupported framework or need custom OS packages, you can supply your own Dockerfile.

Using an officially supported framework

Set the following keys when you rely on Squadbase’s built-in images:

KeyValuesDescription
frameworkstreamlit nextjs morphFramework
runtimepython3.9 python3.10 python3.11 python3.12 node18 node20 node22Runtime
package_managerpip poetry uv npm yarn pnpmPackage manager
entrypointsrc/app.py src/main.py src/index.pyApp entry point

Using a custom Dockerfile

If a Dockerfile exists in the project root, Squadbase ignores framework and builds with your Dockerfile instead.
context and build_args apply only when you bring your own Dockerfile.

Deployment

Deployment settings go under deployment:.
Choose the cloud provider with provider (defaults to gcp).

AWS

KeyTypeDescription
memorynumberMemory (MB)
timeoutnumberTimeout (sec) — max 900
provisioned_concurrencynumberProvisioned concurrency
ephemeral_storagenumberEphemeral storage (MB)

GCP

KeyTypeDescription
memorystring (e.g. 1Gi, 512Mi)Memory
cpunumberCPU
timeoutnumberTimeout (sec) — max 900
concurrencynumberMax concurrent requests
min_instancesnumberMinimum instances
ephemeral_storagestring (e.g. 1Gi, 512Mi)Ephemeral storage

Pricing model

Runtime charges are calculated on memory, request, and CPU.
You pay for resources used according to the spec you define under deployment.

Memory-based ($/GB-sec)Request-based ($/1 M)CPU-based ($/vCPU-sec)
1. AWS$0.0000200000$0.25
2. AWS – standby instances$0.0000050000
3. GCP$0.0000030000$0.50$0.0000270
4. GCP – standby instances$0.0000030000$0.0000270

On this page