Skip to content
bantam.host

Authentication

Authentication unlocks the full power of Bantam CLI, including permanent deployments, custom domains, and project management.

Why Authenticate?

Section titled “Why Authenticate?”

Anonymous Limits

Section titled “Anonymous Limits”

Without authentication, you can:

  • ✅ Deploy files up to 5MB
  • ✅ Get temporary URLs that last 24 hours
  • ⚠️ Limited to 2 uploads per day

Authenticated Benefits

Section titled “Authenticated Benefits”

After logging in, you unlock:

  • 🚀 Permanent deployments - Keep projects online forever
  • 🌐 Custom domains - Use your own domain
  • 📦 Larger uploads - Up to 100MB+ files
  • 📊 Project management - List and manage all deployments
  • ⚡ No daily limits - Deploy as much as you need

Getting Started

Section titled “Getting Started”

  1. Create an Account

    Sign up for free at bantam.host

  2. Generate a Token

    • Go to your dashboard
    • Click on “API Tokens” or “Personal Access Tokens”
    • Create a new token with a descriptive name
    • Copy the token (you won’t see it again!)

  3. Login with CLI

    Terminal window
    bantam login

    Paste your token when prompted.

  4. Verify Authentication

    Terminal window
    bantam list

    If authenticated, you’ll see your projects.

Token Management

Section titled “Token Management”

Creating Tokens

Section titled “Creating Tokens”

Best practices for tokens:

  • Use descriptive names (e.g., “CLI - Work Laptop”)
  • Create separate tokens for different machines
  • Rotate tokens periodically

Token Security

Section titled “Token Security”

Logout

Section titled “Logout”

Remove stored authentication:

Terminal window
bantam logout

Managing Access

Section titled “Managing Access”

View Token Status

Section titled “View Token Status”

Check if you’re authenticated:

Terminal window
bantam whoami

Revoke Tokens

Section titled “Revoke Tokens”

Revoke tokens from the web account page:

  1. Go to bantam.host/account
  2. Navigate to API Tokens
  3. Click “Revoke” next to any token

Troubleshooting

Section titled “Troubleshooting”

Invalid Token Error

Section titled “Invalid Token Error”

If you see “Invalid authentication token”:

  1. Check token is correct - No extra spaces or characters
  2. Generate new token - Old token may be revoked
  3. Try login again:
    Terminal window
    bantam logout
    bantam login

Free Tier Limits

Section titled “Free Tier Limits”

Even with authentication, free tier includes:

  • 1 permanent URL (must log in to bantam.host every 90 days)
  • 2 temporary URLs (up to 3 days expiry, no limit on daily deletion/creation)
  • 10MB storage (2x times unauthenticated users)

Upgrade your plan for unlimited deployments.