CLI

Troubleshooting

Fix common CLI errors, from sign-in and permission errors to commands in the wrong organization.

This page lists the CLI's common errors, grouped by what you were doing, each with its cause and fix.

Signing in

Error: Not logged in. Run featherless-cloud login.

The CLI has no API key on this computer, or not for the profile you passed. Run featherless-cloud login.

Error: Sign in to continue.

The API key was revoked, expired or is no longer valid. Create a new key on the Credentials page and run featherless-cloud login again.

Error: Insufficient permissions.

The key lacks the scope the command needs, such as Instances write to create an instance, or your role doesn't allow the action. Create a key with the scope, or ask an organization owner or admin.

Connecting

Error: Could not connect to …

The CLI can't reach Featherless GPU Cloud. Check your internet connection, and any proxy or firewall in between.

Organizations

Commands act on the wrong organization

A key belongs to the organization that was active when you created it. Create a key in the other organization and store it under its own profile:

featherless-cloud login --profile research
featherless-cloud instance list --profile research

Getting help

If you're still stuck, ask us on Discord. Include:

  • the CLI version, from featherless-cloud --version;
  • the command you ran, without any keys or secrets;
  • the full error, from the same command with --json.