Skip to main content
The gleef login command authenticates your CLI with Gleef using your API key. This is required before using any other commands.

​
Usage

Or provide the API key directly:

​
Options

​
Interactive Authentication

When you run gleef login without the --key flag, you’ll be guided through an interactive process:

​
If you don’t have an API key:

​
If you have an API key:

​
Direct Authentication

For automation or scripts, provide the key directly:

​
Getting Your API Key

1

Access Gleef Dashboard

Visit https://app.gleef.eu/settings/api-keys and log in to your account.
2

Generate API Key

Click “Generate New API Key” and provide a description (e.g., “Simo’s CLI Access”).
3

Copy the Key

Copy the generated API key. You won’t be able to see it again once you close the dialog.
4

Store Securely

Store the key securely - it provides full access to your Gleef account.

​
Authentication Storage

Once authenticated, your API key is stored globally in your user configuration directory:
  • macOS: ~/.config/gleef/config.json
  • Linux: ~/.config/gleef/config.json
  • Windows: %APPDATA%\gleef\config.json
The stored configuration looks like:

​
Security Considerations

Your API key provides full access to your Gleef account. Keep it secure!

​
Best Practices

  1. Never commit API keys - Don’t include them in version control
  2. Use environment variables - For CI/CD and automation
  3. Rotate keys regularly - Generate new keys periodically
  4. Limit key access - Use separate keys for different environments
  5. Revoke unused keys - Remove keys that are no longer needed

​
Environment Variables

For CI/CD pipelines, you can set the API key as an environment variable:
The CLI will automatically use this environment variable if no key is stored locally.

​
Verification

To verify your authentication is working:
If authentication fails, you’ll see an error message:

​
Re-authentication

To change your API key or re-authenticate:
  1. Run login again: gleef login will overwrite the existing key
  2. Use direct flag: gleef login --key NEW_API_KEY
  3. Delete config: Remove the config file and run gleef login

​
Troubleshooting

​
Invalid API Key Error

Solutions:
  • Verify the key was copied correctly (no extra spaces)
  • Check if the key has been revoked in the Gleef dashboard
  • Ensure you’re using the correct account/workspace

​
Network Connection Issues

If you can’t reach the Gleef servers:
  • Check your internet connection
  • Verify corporate firewall settings
  • Try using a VPN if behind restrictive network policies

​
Permission Issues

If you get file permission errors:
  • macOS/Linux: Check permissions on ~/.config/gleef/
  • Windows: Ensure you have write access to %APPDATA%\gleef\

​
Examples

​
Basic Login

​
Direct Login

​
Script Usage

​
Next Steps

After successful authentication:

Initialize Project

Set up Gleef in your project

Quick Start

Complete your first translation workflow