Environment Variables

In Morphis, environment variables are resolved per HTTP server. That behavior is part of the server runtime and CLI flow, which is why this page sits under HTTP.

Each server reads from its own env file in the project root, and commands such as morphis dev, morphis build, morphis start, morphis route:list, and morphis deploy resolve the target file from the selected server and optional environment name.

Default file layout

When you create a new project, Morphis generates .env.api:

NAME=api
PORT=3000
MULTI_THREAD=true

If you add another server such as chat, Morphis creates another server-specific file:

NAME=chat
PORT=3001
MULTI_THREAD=true

Resolution rules

The CLI resolves env targets with these patterns:

morphis dev --server=api
morphis dev --server=api --env=dev
morphis start --env-file=.env.dev.api

From the current implementation:

• --server=api resolves to .env.api
• --server=api --env=dev resolves to .env.dev.api
• --env-file=.env.dev.api uses that explicit file and derives the server name from it when needed

If both --server and --env-file are provided, they must agree on the same server name.

Built-in variables

Database variables

Database-related env values depend on the selected driver and your generated config.

For example, a SQLite or D1-oriented setup may include:

DB_STORAGE=./database.sqlite

When you add a D1 connection, Morphis can also add values such as:

D1_BINDING=DB
CLOUDFLARE_D1_BINDING=DB
CLOUDFLARE_D1_DATABASE_NAME=your-cloudflare-d1-name
CLOUDFLARE_D1_DATABASE_ID=your-cloudflare-d1-uuid
DB_STORAGE=./database.sqlite

Custom variables

Application-specific settings live in the same file:

NAME=api
PORT=3000
MULTI_THREAD=true
 
JWT_SECRET=change-me
FEATURE_FLAG_NEW_BILLING=true

Read them through process.env:

const secret = process.env.JWT_SECRET;

Creating env variants

Use morphis new:env to create an environment-specific copy of a server env file:

morphis new:env dev --server=api

That creates .env.dev.api and injects:

ENV=dev

at the top of the generated file.