Environment Variables

Pass environment variables to Wassette components using shell exports or config files. Components need explicit permission to access variables.

Server Configuration

Wassette supports the following environment variables for server configuration (following the twelve-factor app methodology):

PORT

Sets the port number for HTTP-based transports (SSE and StreamableHttp) when bind_address is not specified via CLI or config file.

PORT=8080 wassette serve --streamable-http

Default: 9001

Precedence: CLI (--bind-address) > Config file (bind_address) > PORT/BIND_HOST > Default (127.0.0.1:9001)

BIND_HOST

Sets the host address to bind to for HTTP-based transports when bind_address is not specified via CLI or config file.

BIND_HOST=0.0.0.0 wassette serve --streamable-http

Default: 127.0.0.1 (localhost only)

Note: In Docker containers, use BIND_HOST=0.0.0.0 to allow external connections.

Precedence: CLI (--bind-address) > Config file (bind_address) > PORT/BIND_HOST > Default (127.0.0.1:9001)

WASSETTE_CONFIG_FILE

Path to custom configuration file.

WASSETTE_CONFIG_FILE=/path/to/config.toml wassette serve

Default: $XDG_CONFIG_HOME/wassette/config.toml

Component Environment Variables

Quick Start

export OPENWEATHER_API_KEY="your_key"
wassette run
wassette permission grant environment-variable weather-tool OPENWEATHER_API_KEY

Use wassette secret set to securely pass environment variables to components:

wassette secret set weather-tool API_KEY "your_secret_key"

This stores the secret securely and makes it available to the component when granted permission.

Grant Access

wassette permission grant environment-variable weather-tool API_KEY

Or in policy file:

version: "1.0"
permissions:
  environment:
    allow:
      - key: "API_KEY"

See Also