sf login

Log in, log out, and account status

sf login

sf login --server https://<your StarForge domain>   # Specify on first login; remembered afterward
sf login                                    # Browser authorization (default)
sf login --device-flow                      # Device-code login (SSH / no browser)
sf login --token <TOKEN>                    # Non-interactive (CI)

Option	Description
-s, --server	StarForge server address; if omitted, uses the last remembered value / the FORGE_SERVER environment variable
--token	Log in directly with a service token, skipping the browser (for CI)
--device-flow	Force the device-code flow
--no-browser	Same as --device-flow

Login state is written to ~/.forge/ (permissions 0600). The browser flow uses OAuth + PKCE; when the platform is configured with OIDC (e.g. Casdoor), it automatically redirects to single sign-on.

Console login. The same page is used when sf login opens a browser.

sf logout

sf logout

Revokes the refresh token and clears the local login state.

sf status

sf status

Outputs: current account and role, quotas (concurrent GPUs / jobs / daily GPU-hours), current usage, available hardware profiles, and the list of active jobs. Checking the watermark before submitting is a good habit.

sf login

Log in to StarForge

sf login [options]

Option	Description
--server, -s	StarForge server address (default https://starforge.gcoreinc.com)
--token	Non-interactive login: use a service token (for CI)
--device-flow	Force the device-code login (SSH / no browser)
--no-browser	Do not open a browser (same as —device-flow)