Access Your Dashboard & Spice Pass

Your Spice Pass is the authentication token that connects the Surveyor CLI to your Spice Labs account. This guide walks you through logging into the dashboard and generating your credentials.

Step 1: Log In to the Dashboard

Go to https://dashboard.spicelabs.io and log in with your email address or select “Continue with Google”.

Get Started

Step 2: Verify Your Email

Check your email inbox for the login verification message, then click “Log in”.

  • If you have been invited to join an organization, click “Log in” from the invitation email
Join Organization

Step 3: Access Org, Project and User Settings

Click the arrow to extend the Settings menu

Extend Menu
Menu Extended

Step 4: Generate your Spice_Pass

From the Dashboard

  1. Expand the “Settings” section
  2. Select “Projects”
  3. Click the link to “get your Spice_Pass”
Click Spice Pass

Step 5: Generate Your Credentials

Choose the Spice Pass validation duration and click “Generate credentials”.

Generate Spice Pass

Step 6: Copy Your Spice Pass

Copy and/or download your Spice Pass token.

Copy or Download Spice Pass

Step 7: Set Your Environment Variable

Use the export command to set your SPICE_PASS for the current shell:

export SPICE_PASS=<paste your JWT token here>

Step 8: Make It Permanent (Optional)

Add your SPICE_PASS to your shell configuration file for future sessions. Choose the appropriate file for your shell:

For Bash:

echo 'export SPICE_PASS="<paste your JWT token here>"' >> ~/.bashrc

For Zsh (macOS default):

echo 'export SPICE_PASS="<paste your JWT token here>"' >> ~/.zshrc

For PowerShell (Windows):

[System.Environment]::SetEnvironmentVariable('SPICE_PASS', '<paste your JWT token here>', 'User')

What’s Next?

Now that you have your Spice Pass configured, you can:


💡 Security First

Your Spice Pass is a sensitive credential. Never commit it to version control or share it publicly. Store it securely in environment variables or a secrets manager.

ℹ️ Token Expiration

Spice Pass tokens have configurable expiration times. If your token expires, simply generate a new one following the same steps.