Environment Variables

Configure CloudCLI UI using environment variables or a .env file.

CloudCLI UI is configured using environment variables. For local development and self-hosted setups, you can define these in a .env file at the project root.

Getting Started

bash

cp .env.example .env

Then edit .env with your preferred settings.

Available Variables

Variable	Default	Description
`PORT`	`3001`	Port the server listens on
`WORKSPACES_ROOT`	`~`	Root directory for project discovery
`ENABLE_HTTPS`	`false`	Enable HTTPS (requires cert setup)
`AUTH_TOKEN`	—	Optional token to password-protect the UI

Custom Port

To run on a different port:

bash

# Via .env
PORT=8080

# Via CLI flag (overrides .env)
cloudcli --port 8080

Restricting Project Discovery

By default CloudCLI UI discovers all sessions under your home directory. To restrict it to a specific workspace:

bash

WORKSPACES_ROOT=/home/user/projects

This is useful on shared or remote servers where you want to limit which directories are accessible through the UI.