Production checklist

Production Deployment

Lasso is a standard Elixir/Phoenix release. It runs anywhere you can deploy an OTP release: containers, VMs, bare metal, or PaaS platforms.

Building a Release

MIX_ENV=prod mix deps.get
MIX_ENV=prod mix assets.setup
MIX_ENV=prod mix assets.deploy
MIX_ENV=prod mix release

Or build a Docker image using the included Dockerfile.

Production environment variables

Variable	Description
`SECRET_KEY_BASE`	Phoenix signing/encryption secret. Generate with `mix phx.gen.secret` (64+ bytes)
`PHX_HOST`	Set your public hostname for URL generation (e.g., `rpc.example.com`); defaults to `localhost`
`PHX_SERVER`	Optional. Production already starts the HTTP server; the release `bin/server` wrapper sets this explicitly
`LASSO_NODE_ID`	Unique, stable identifier for this node. Required in production. Convention: use region names (e.g., `us-east-1`) for geo-distributed deployments
`PORT`	HTTP listener port (default: `4000`)

Provider API Keys

Provider URLs in profile YAML support ${ENV_VAR} substitution. Unresolved placeholders crash at startup.

providers:
  - id: "alchemy_ethereum"
    url: "https://eth-mainnet.g.alchemy.com/v2/${ALCHEMY_API_KEY}"

Set the variable in your environment or secrets manager:

export ALCHEMY_API_KEY="your-key-here"

Health Check

Core v0.5.0 exposes GET /api/health for application liveness and GET /api/ready for route readiness. Configure your orchestrator to use health for process availability. Scope readiness with profile and chain when a load balancer needs to assess one application route. The health endpoint confirms that the application is running and reports cluster topology. Readiness uses local eligible HTTP routes and fresh head observations; it does not make a live upstream request. Pair both endpoints with an upstream-backed RPC check for your actual method and provider pool.

HTTPS

Lasso serves HTTP. Terminate TLS at your reverse proxy or load balancer. Set PHX_HOST to your public hostname. Production URL generation defaults to HTTPS; set PHX_SCHEME=http when serving locally without a TLS proxy.