Environment Configuration

Environment variables for Pierre Fitness Platform. Copy .envrc.example to .envrc and customize.

Setup

cp .envrc.example .envrc
# edit .envrc with your settings
direnv allow  # or: source .envrc

Required Variables

Variable	Description	Example
`DATABASE_URL`	Database connection string	`sqlite:./data/users.db`
`PIERRE_MASTER_ENCRYPTION_KEY`	Master encryption key (base64)	`openssl rand -base64 32`

Server Configuration

Variable	Default	Description
`HTTP_PORT`	`8081`	Server port
`RUST_LOG`	`info`	Log level (debug, info, warn, error)
`JWT_EXPIRY_HOURS`	`24`	JWT token expiration
`PIERRE_RSA_KEY_SIZE`	`4096`	RSA key size (2048 for dev, 4096 for prod)

Database

SQLite (Development)

export DATABASE_URL="sqlite:./data/users.db"

PostgreSQL (Production)

export DATABASE_URL="postgresql://user:pass@localhost/pierre_db"
export POSTGRES_MAX_CONNECTIONS="10"
export POSTGRES_MIN_CONNECTIONS="0"
export POSTGRES_ACQUIRE_TIMEOUT="30"

SQLx Pool Configuration

Fine-tune database connection pool behavior:

Variable	Default	Description
`SQLX_IDLE_TIMEOUT_SECS`	`600`	Seconds before idle connections are closed
`SQLX_MAX_LIFETIME_SECS`	`1800`	Maximum connection lifetime in seconds
`SQLX_TEST_BEFORE_ACQUIRE`	`true`	Validate connections before use
`SQLX_STATEMENT_CACHE_CAPACITY`	`100`	Prepared statement cache size

Tokio Runtime Configuration

Configure the async runtime for performance tuning:

Variable	Default	Description
`TOKIO_WORKER_THREADS`	CPU cores	Number of worker threads
`TOKIO_THREAD_STACK_SIZE`	OS default	Thread stack size in bytes
`TOKIO_THREAD_NAME`	`pierre-worker`	Worker thread name prefix

Provider Configuration

Default Provider

export PIERRE_DEFAULT_PROVIDER=strava  # strava, garmin, fitbit, whoop, coros, synthetic

Strava

# required for strava oauth
export PIERRE_STRAVA_CLIENT_ID=your-client-id
export PIERRE_STRAVA_CLIENT_SECRET=your-client-secret

Garmin

# required for garmin oauth
export PIERRE_GARMIN_CLIENT_ID=your-consumer-key
export PIERRE_GARMIN_CLIENT_SECRET=your-consumer-secret

Fitbit

export PIERRE_FITBIT_CLIENT_ID=your-client-id
export PIERRE_FITBIT_CLIENT_SECRET=your-client-secret

WHOOP

export PIERRE_WHOOP_CLIENT_ID=your-client-id
export PIERRE_WHOOP_CLIENT_SECRET=your-client-secret

COROS

# required for coros oauth (apply for API access first)
export PIERRE_COROS_CLIENT_ID=your-client-id
export PIERRE_COROS_CLIENT_SECRET=your-client-secret

Note: Redirect URIs are automatically constructed by the server based on the HOST and HTTP_PORT configuration. No *_REDIRECT_URI environment variables are needed.

Note: COROS API documentation is private. Apply at COROS Developer Portal.

Terra (150+ Wearables)

export TERRA_API_KEY=your-api-key
export TERRA_DEV_ID=your-dev-id
export TERRA_WEBHOOK_SECRET=your-webhook-secret

Synthetic (No Credentials Needed)

export PIERRE_DEFAULT_PROVIDER=synthetic
# no oauth credentials required - works out of the box

Algorithm Configuration

Configure fitness calculation algorithms via environment variables.

Variable	Default	Options
`PIERRE_MAXHR_ALGORITHM`	`tanaka`	fox, tanaka, nes, gulati
`PIERRE_TRIMP_ALGORITHM`	`hybrid`	bannister_male, bannister_female, edwards_simplified, lucia_banded, hybrid
`PIERRE_TSS_ALGORITHM`	`avg_power`	avg_power, normalized_power, hybrid
`PIERRE_VDOT_ALGORITHM`	`daniels`	daniels, riegel, hybrid
`PIERRE_TRAINING_LOAD_ALGORITHM`	`ema`	ema, sma, wma, kalman
`PIERRE_RECOVERY_ALGORITHM`	`weighted`	weighted, additive, multiplicative, minmax, neural
`PIERRE_FTP_ALGORITHM`	`from_vo2max`	20min_test, 8min_test, ramp_test, from_vo2max, hybrid
`PIERRE_LTHR_ALGORITHM`	`from_maxhr`	from_maxhr, from_30min, from_race, lab_test, hybrid
`PIERRE_VO2MAX_ALGORITHM`	`from_vdot`	from_vdot, cooper, rockport, astrand, bruce, hybrid

See configuration.md for algorithm details.

Fitness Configuration

Effort Thresholds (1-10 Scale)

export FITNESS_EFFORT_LIGHT_MAX="3.0"
export FITNESS_EFFORT_MODERATE_MAX="5.0"
export FITNESS_EFFORT_HARD_MAX="7.0"
# > 7.0 = very_high

Heart Rate Zone Thresholds (% of Max HR)

export FITNESS_ZONE_RECOVERY_MAX="60.0"
export FITNESS_ZONE_ENDURANCE_MAX="70.0"
export FITNESS_ZONE_TEMPO_MAX="80.0"
export FITNESS_ZONE_THRESHOLD_MAX="90.0"
# > 90.0 = vo2max

Personal Records

export FITNESS_PR_PACE_IMPROVEMENT_THRESHOLD="5.0"

Weather Integration

export OPENWEATHER_API_KEY="your-api-key"
export FITNESS_WEATHER_ENABLED="true"
export FITNESS_WEATHER_WIND_THRESHOLD="15.0"
export FITNESS_WEATHER_CACHE_DURATION_HOURS="24"
export FITNESS_WEATHER_REQUEST_TIMEOUT_SECONDS="10"
export FITNESS_WEATHER_RATE_LIMIT_PER_MINUTE="60"

Rate Limiting

export RATE_LIMIT_ENABLED="true"
export RATE_LIMIT_REQUESTS="100"
export RATE_LIMIT_WINDOW="60"  # seconds

Cache Configuration

export CACHE_MAX_ENTRIES="10000"
export CACHE_CLEANUP_INTERVAL_SECS="300"
export REDIS_URL="redis://localhost:6379"  # optional, uses in-memory if not set

Backup Configuration

export BACKUP_ENABLED="true"
export BACKUP_INTERVAL="21600"  # 6 hours in seconds
export BACKUP_RETENTION="7"      # days
export BACKUP_DIRECTORY="./backups"

Activity Limits

export MAX_ACTIVITIES_FETCH="100"
export DEFAULT_ACTIVITIES_LIMIT="20"

OAuth Callback

export OAUTH_CALLBACK_PORT="35535"  # bridge callback port for focus recovery

Development Defaults

For dev/test only (leave empty in production):

# Regular user defaults (for OAuth login form)
export OAUTH_DEFAULT_EMAIL="user@example.com"
export OAUTH_DEFAULT_PASSWORD="userpass123"

# Admin user defaults (for setup scripts)
export ADMIN_EMAIL="admin@pierre.mcp"
export ADMIN_PASSWORD="adminpass123"

Frontend Configuration

export VITE_BACKEND_URL="http://localhost:8081"

Production vs Development

Setting	Development	Production
`DATABASE_URL`	sqlite	postgresql
`PIERRE_RSA_KEY_SIZE`	2048	4096
`RUST_LOG`	debug	info
Redirect URIs	http://localhost:…	https://…
`OAUTH_DEFAULT_*`	set	empty

Security Notes

Never commit .envrc (gitignored)
Use HTTPS redirect URIs in production
Generate unique PIERRE_MASTER_ENCRYPTION_KEY per environment
Rotate provider credentials periodically

Keyboard shortcuts

Pierre Fitness Intelligence