Skip to main content

Quick Start

This guide walks you through setting up a new inforge project from scratch.

1. Create the project structure​

my-infra/
├── inforge.yaml              # project config (+ optional provider defaults)
├── inforge.prd.yaml          # stack config for prd environment
└── resources/
    └── prd/                  # defined once, instantiated into every region
        ├── variables.yaml    # base_domain + SSH config
        ├── regions.yaml      # regions + per-region provider config
        └── regional/
            ├── network/
            │   └── ingress/manifest.yaml
            ├── compute/
            │   └── bridge/
            │       ├── manifest.yaml
            │       └── cloud-init.sh
            └── service/
                └── api/
                    ├── manifest.yaml
                    └── environment.yaml

2. Write inforge.yaml​

name: my-infra
backend:
  type: file
  url: file://.pulumi

providers:            # project-level defaults — resources can omit provider:
  compute: hetzner
  database:
    postgresql: neon

See inforge.yaml reference for all backend types (file, git-branch, s3, r2).

3. Write inforge.prd.yaml​

config:
  environment: prd
  hcloud:token: ""         # set via HCLOUD_TOKEN env var
  cloudflare:apiToken: ""  # set via CLOUDFLARE_API_TOKEN env var

4. Write resources/prd/variables.yaml​

base_domain: example.com
ssh:
  authorizedKeys: "ssh-ed25519 AAAA... user@host"
  deployPublicKey: "ssh-ed25519 AAAA... deploy@host"

4b. Write resources/prd/regions.yaml​

regions:
  eu-central-1:
    slug: euc1
    dns:
      provider: cloudflare
      zone: ""               # Cloudflare Zone ID derived records are created in
    providers:
      hetzner:
        apiToken: ${HCLOUD_TOKEN}
        location: nbg1
        network_zone: eu-central
        serverTypes: {SMALL: cx23, MEDIUM: cx33, LARGE: cx43}
        images: {ubuntu-24.04: ubuntu-24.04}
      cloudflare:
        apiToken: ${CLOUDFLARE_API_TOKEN}

5. Write a compute resource​

resources/prd/regional/compute/bridge/manifest.yaml
name: bridge
container: bridge
# provider: omitted — inherits providers.compute: hetzner from inforge.yaml
network: ingress
size: SMALL
image: ubuntu-24.04
cloud_init: cloud-init.sh

6. Validate​

inforge validate prd

7. Preview​

inforge preview --stack prd --stack-config inforge.prd.yaml

8. Deploy​

inforge deploy --stack prd --stack-config inforge.prd.yaml --yes

Next steps​