Configuration
Overview
Use fenwave config commands to view and update agent settings. All configuration is stored under ~/.fenwave/.
Viewing Current Settings
fenwave config show
Available Settings
| Setting | Description | Default |
|---|---|---|
backendUrl |
Fenwave IDP backend URL | http://localhost:7007 |
frontendUrl |
Fenwave IDP frontend URL | http://localhost:3000 |
wsPort |
Port for the local agent server | 3001 |
containerPort |
Port for the DevApp dashboard | 3003 |
Updating Settings
fenwave config set --backend-url https://backstage.mycompany.com
fenwave config set --frontend-url https://portal.mycompany.com
fenwave config set --ws-port 3005
fenwave config set --container-port 3010
You can combine multiple flags in one command:
fenwave config set --backend-url https://backstage.mycompany.com --frontend-url https://portal.mycompany.com
Resetting to Defaults
fenwave config reset
Restart required
Changes to port settings take effect after restarting the agent with fenwave service restart.
Local Storage Reference
All agent data lives under ~/.fenwave/:
| Path | Content |
|---|---|
config/agent.json |
Agent settings |
config/workspaces.json |
Registry of deployed apps and their local workspace paths |
session/config.json |
Your active login session |
device/credential.json |
Encrypted credentials identifying this machine |
docker/<app>-<version>/ |
Local Docker Compose files for each deployed app version |
registries/credentials.json |
Saved Docker registry credentials |
logs/agent.log |
Activity log (rotated at 10 MB) |
logs/agent.error.log |
Error log |
setup/ |
Setup wizard progress (allows resuming if interrupted) |
daemon/ |
Background service state |
ws-token |
Local auth token used by the DevApp |