Docs

Authentication

Overview

The Fenwave Agent uses a browser-based login to link your local machine to the Fenwave platform. Once logged in, the agent keeps your session active while it’s running and detects when you log out or your session expires.

Logging In

Run the following command to authenticate:

fenwave login

A browser window opens with the Fenwave login page. Sign in with your Fenwave account — the agent automatically captures the result and saves your session locally.

Custom Backend or Frontend URL

If your Fenwave instance is hosted at a custom address:

fenwave login --backend-url https://backstage.mycompany.com
fenwave login --backend-url https://backstage.mycompany.com --frontend-url https://portal.mycompany.com

To save these URLs permanently to the agent config, add --save:

fenwave login --backend-url https://backstage.mycompany.com --save

Session Lifecycle

  • Your session is stored locally at ~/.fenwave/session/config.json
  • The session expires after 7 days
  • While the agent is running, it monitors the session and initiates a graceful shutdown if it detects an expiry or logout
  • Once stopped, re-run fenwave login before starting the agent again

Logging Out

fenwave logout

This clears your local session. If the agent is running, it will shut down gracefully.

Checking Your Status

To see the current state of your session and device registration:

fenwave status

This shows:

  • Session — Active or expired, with the expiry time
  • Device — Whether this machine is registered with Backstage
  • Agent — Whether the agent service is currently running