Environment Variables

This guide lists all required environment variables for each application.

Variables per app

# Appwrite Configuration
NEXT_PUBLIC_APPWRITE_PROJECT_ID=your_project_id
NEXT_PUBLIC_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
APPWRITE_API_KEY=your_server_api_key

# Vipps Payment
VIPPS_CLIENT_ID=your_client_id
VIPPS_CLIENT_SECRET=your_client_secret
VIPPS_SUBSCRIPTION_KEY=your_subscription_key
VIPPS_MERCHANT_SERIAL_NUMBER=your_merchant_serial
VIPPS_SYSTEM_NAME=BISO-Sites
VIPPS_SYSTEM_VERSION=1.0.0

# Application
NEXT_PUBLIC_BASE_URL=http://localhost:3000
NEXT_PUBLIC_APPWRITE_DATABASE_ID=your_database_id

# Optional: AI Features
OPENAI_API_KEY=your_openai_key

Verify your setup

Obtaining Credentials

Appwrite

1. Sign up at cloud.appwrite.io or self-host
2. Create a project
3. Get Project ID from project settings
4. Create API key with required scopes

Vipps

1. Register at Vipps Developer Portal
2. Create merchant account
3. Obtain API credentials from portal

Production Setup

Use your hosting provider's environment variable settings:

• Vercel: Project Settings → Environment Variables
• Netlify: Site Settings → Build & Deploy → Environment
• Docker: Use .env file or docker-compose environment

Storage recommendations

• Local development: .env.local files kept out of Git—share updates through 1Password or another secure vault.
• Secrets management: Mirror production values in a shared vault and note who has access to Appwrite, Vipps, and hosting consoles.
• Rotation checklist: Update this page and the vault whenever keys rotate so the next maintainer can trace changes.

Related Documentation

• Deployment Overview
• Appwrite Setup