Skip to main content
Interactive command — Authenticates with your Fjall account for API access.

​
Overview

The fjall login command authenticates with your Fjall account and stores API credentials locally. This enables access to Fjall’s cloud services and remote features.

​
Usage

fjall login

​
Authentication Flow

​
First-Time Login

fjall login
The command will walk you through logging into your Fjall account: 
The login command will walk you through logging into your Fjall account.
If necessary the command will create a CLI API Key and store the credentials in ~/fjall/.

? What is your Fjall email/username? [email protected]
? What is your Fjall account password? ********

Successfully logged into Fjall.

​
Existing Credentials

If you’re already logged in, you’ll be prompted: 
? You already have credentials saved, if you continue these will be overwritten. 
  Do you wish to proceed? (Y/n)

​
How It Works

  1. Prompts for credentials - Email/username and password
  2. Creates API key - Generates a CLI-specific API key
  3. Stores locally - Saves credentials in ~/fjall/
  4. Validates access - Confirms authentication succeeded

​
Credential Storage

Fjall stores credentials securely in your home directory: 
~/fjall/
└── credentials.json
These credentials are:
  • Stored locally only
  • Used for API authentication
  • Not shared or synced
  • Can be deleted anytime

​
Use Cases

​
Initial Setup

After installing Fjall CLI: 
# Install globally
npm install -g @fjall/cli

# Login to your account
fjall login

​
Switching Accounts

To use a different Fjall account: 
# This will overwrite existing credentials
fjall login

​
CI/CD Integration

For automated environments, set credentials via environment variables instead of using login: 
export FJALL_API_KEY=your-api-key
# Commands will use env var instead of stored credentials

​
Security

​
Best Practices

  1. Protect credentials - Keep ~/fjall/ directory secure
  2. Use unique passwords - Don’t reuse passwords
  3. Regular rotation - Update credentials periodically
  4. Logout when done - Remove credentials if needed

​
Removing Credentials

To logout and remove stored credentials: 
# Manual removal
rm -rf ~/fjall/credentials.json

​
Troubleshooting

​
Authentication Failed

If login fails: 
Authentication failed, please check your credentials and try again.
Possible causes:
  • Incorrect email/username
  • Wrong password
  • Account doesn’t exist
  • Network issues
Solutions:
  1. Verify credentials are correct
  2. Reset password if forgotten
  3. Check network connectivity
  4. Contact support if issues persist

​
Can’t Find Credentials

If commands say you’re not authenticated:
  • Run fjall login again
  • Check ~/fjall/ exists
  • Ensure file permissions are correct

​
Multiple Users

For shared machines:
  • Each OS user has separate credentials
  • Stored in their home directory
  • No conflicts between users

​
Integration with Fjall Services

Once logged in, you can access:
  • Remote deployment features
  • Cloud synchronisation
  • Team collaboration tools
  • Usage analytics

​
Next Steps

After logging in:
  • Create infrastructure: fjall create app
  • Deploy to cloud: fjall deploy
  • Manage resources: fjall list
The login command is optional for local-only usage. It’s required for features that interact with Fjall’s cloud services.