Quick Start

Get from zero to using Soup in under 5 minutes.

1. Sign Up

Create your free account at app.getsoup.dev

2. Install the CLI

curl -fsSL https://cli.getsoup.dev/install.sh | sh

The installer downloads the correct binary for your platform (Linux/macOS x64/ARM).

3. Login

# Opens browser for GitHub login
soup login

# Or use device flow for remote/headless machines
soup login --device

4. Create a Project

Via dashboard or CLI:

soup project create my-app
soup env create my-app root
soup env create my-app development --parent root
soup env create my-app production --parent root

Environments inherit from their parent. Name them whatever you want.

5. Add Secrets

# Set in root (inherited by child environments)
soup secrets set DATABASE_URL postgres://localhost/myapp
soup secrets set LOG_LEVEL debug

# Override in production
soup secrets set --env production LOG_LEVEL warn
soup secrets set --env production DATABASE_URL postgres://prod-db/myapp

6. Use Secrets

# Inject as env vars and run your app
soup run -- npm start

# Export to shell
eval $(soup secrets export)

# Download as .env file
soup secrets download > .env

7. Add a Feature Flag

soup flags create dark-mode
soup flags on dark-mode

Then evaluate via API:

curl https://app.getsoup.dev/api/v1/projects/my-app/environments/production/flags/dark-mode/evaluate \
  -H "Authorization: Bearer $SOUP_TOKEN" \
  -d '{"context": {"user_id": "123"}}'

Next Steps

• Authentication - API tokens, service accounts
• Secrets Module - Variable references, inheritance
• Feature Flags - Targeting, rollouts, variants
• API Reference - Full REST API docs