CLI Reference

drift login -a https://api.drift.velozengineering.ch -e [email protected] -p mypass
# Logged in as [email protected]

drift target -o mycompany -s production
# API:   https://api.drift.velozengineering.ch
# Org:   mycompany
# Space: production

drift orgs
# mycompany
# another-org

drift create-org mycompany
# Created org mycompany

drift delete-org mycompany

drift org-users mycompany
# EMAIL              NAME    ROLES
# [email protected]  Admin   OrgManager, BillingManager
# [email protected]    Dev     OrgAuditor

drift set-org-role [email protected] mycompany OrgManager
# Set role OrgManager for [email protected] in org mycompany

drift invite [email protected] --org firma-ag --role OrgManager
# Invite sent to [email protected] (expires in 7 days)

drift invites --org firma-ag
# EMAIL            ROLE        STATUS   EXPIRES
# [email protected]     OrgManager  pending  2026-03-29

drift revoke-invite inv_abc123

drift spaces
# dev
# staging
# production

drift create-space staging
# Created space staging

drift delete-space staging

drift set-space-role [email protected] mycompany staging SpaceDeveloper

drift apps
# NAME    STATE    INSTANCES  MEMORY
# web     STARTED  2          512M
# worker  STARTED  1          256M

drift push myapp --docker-image registry.example.com/myapp:v1.2 -i 2 -m 512
# Pushed myapp (state: STARTED)

drift app myapp
# Name:       myapp
# State:      STARTED
# Instances:  2
# Memory:     512M
# Image:      registry.example.com/myapp:v1.2

drift delete myapp
# Deleted myapp

drift start myapp

drift stop myapp

drift restart myapp
# Restarting myapp (rolling restart)

drift deployment myapp
# App:        myapp
# Strategy:   canary
# Status:     in-progress
# Current:    myregistry/myapp:v1 (2 instances)
# Target:     myregistry/myapp:v2 (canary: 1/3 healthy)

drift rollback myapp
# Rolled back myapp to previous version (myregistry/myapp:v1)

drift scale myapp -i 3 -m 1024
# Scaled myapp to 3 instances

drift env myapp
# NODE_ENV=production
# PORT=8080

drift set-env myapp NODE_ENV production

drift set-health myapp --type http --endpoint /healthz

drift ssh myapp

drift logs myapp -r -n 50

drift marketplace
# SERVICE     PLANS                DESCRIPTION
# postgres    small, medium, ...   PostgreSQL 16 database
# redis       small, medium, ...   Redis 7 in-memory store

drift services
# NAME   SERVICE   PLAN    STATUS
# mydb   postgres  small   ready

drift service mydb
# Name:      mydb
# Service:   postgres
# Plan:      small
# Status:    ready

drift create-service postgres small mydb
# Created service instance mydb

drift delete-service mydb
# Deleted service mydb

drift bind-service myapp mydb
# Bound mydb to myapp

drift unbind-service myapp mydb
# Unbound mydb from myapp

drift share-service mydb -s staging
# Shared mydb to space staging

drift unshare-service mydb -s staging

drift create-service-key mydb external-access
# Created service key external-access

drift service-keys mydb
# external-access

drift service-key mydb external-access
# {
#   "host": "drift-pg-abc12345",
#   "port": 5432,
#   "database": "db_1a2b3c4d",
#   "username": "u_5e6f7g8h",
#   "password": "...",
#   "uri": "postgres://..."
# }

drift delete-service-key mydb external-access

drift backups mydb
# ID         STATUS     SIZE    TYPE      CREATED
# bk_abc123  completed  24MB    manual    2026-03-22 02:00
# bk_def456  completed  23MB    scheduled 2026-03-21 02:00

drift create-backup mydb
# Backup bk_abc123 started (running in background)

drift restore-backup bk_abc123
# Restore started for bk_abc123

drift restore-backup bk_abc123 --to mydb-staging
# Restore started for bk_abc123 → mydb-staging

drift delete-backup bk_abc123

drift backup-schedule mydb
# Schedule: 0 2 * * * (daily at 02:00)
# Retention: 7 backups
# Enabled: true
# Last run: 2026-03-22 02:00
# Next run: 2026-03-23 02:00

drift set-backup-schedule mydb --cron "0 2 * * *" --retention 14

drift unset-backup-schedule mydb

drift routes
# HOSTNAME  DOMAIN                         PATH  APPS
# myapp     drift.velozengineering.ch       /     myapp

drift domains
# NAME                          TYPE     INTERNAL
# drift.velozengineering.ch     shared   false
# mycompany.ch                  private  false

drift create-domain mycompany mycompany.ch
# Created domain mycompany.ch for org mycompany

drift map-route myapp mycompany.ch --hostname www
# Mapped route www.mycompany.ch to myapp

drift unmap-route myapp mycompany.ch --hostname www

drift plans
# NAME        PRICE (CHF)  APPS  SERVICES  MEMORY  USERS
# Free        CHF 0/mo     3     2         512M    3
# Developer   CHF 29/mo    10    10        4096M   5
# Team        CHF 99/mo    50    50        16384M  25
# Business    CHF 299/mo   ∞     ∞         65536M  ∞

drift subscription
# Plan:   team
# Status: active
# Period: 2024-01-01 → 2024-02-01

drift upgrade business
# Subscription updated to business (status: active)

drift usage
# RESOURCE   USED  LIMIT
# Apps       5     50
# Services   8     50
# Memory     4096M 16384M
# Users      3     25

drift invoices
# ID        AMOUNT      STATUS  PERIOD
# a1b2c3d4  CHF 99.00   paid    2024-01-01 → 2024-02-01

drift create-api-key ci-deploy --scopes apps:write --expires 90d
# API key created: ci-deploy
# Key: dk_a1b2c3d4...
# ⚠️  Save this key — it won't be shown again!

drift api-keys
# NAME       PREFIX   SCOPES       EXPIRES     LAST USED
# ci-deploy  dk_a1b2  apps:write   2024-04-15  2024-01-20 14:30

drift delete-api-key ci-deploy

drift create-webhook deploys https://hooks.example.com/drift --events app.push,app.crash
# Webhook created: deploys
# Secret: whsec_...
# ⚠️  Save this secret — it won't be shown again!

drift webhooks
# NAME     URL                              EVENTS              ACTIVE
# deploys  https://hooks.example.com/drift  app.push,app.crash  true

drift webhook-deliveries deploys

drift delete-webhook deploys

drift events
# TIME                 TYPE        TARGET      ACTOR
# 2024-01-20 14:30:00  app.push    app myapp   [email protected]

drift quotas
# NAME     MEMORY  APPS  SERVICES  ROUTES
# default  4096M   10    10        20

drift version
# drift v1.0.0 (commit: abc1234, built: 2024-01-15)