Supabase CLI Installation Guide - Windows

Quick guide to install Supabase CLI on Windows to deploy Edge Functions.

Option 1: NPM (Recommended - Easiest)

Install

npm install -g supabase

Verify Installation

supabase --version

You should see something like: 1.200.3

Common Issues

Error: "npm command not found"

• Install Node.js from https://nodejs.org (LTS version recommended)

• Restart your terminal after installing

Error: "Permission denied"

• Run PowerShell as Administrator

• Or use npm install -g supabase --force

---

Option 2: Scoop (Windows Package Manager)

1. Install Scoop (if not installed)

Open PowerShell and run:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

2. Install Supabase CLI

scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase

3. Verify Installation

supabase --version

---

Option 3: Direct Download (No Package Manager)

1. Download Binary

Go to: https://github.com/supabase/cli/releases/latest

Download: supabase_windows_amd64.zip

2. Extract and Add to PATH

# Extract to a permanent location
Expand-Archive supabase_windows_amd64.zip -DestinationPath C:\supabase

# Add to PATH (PowerShell - Admin required)
$env:Path += ";C:\supabase"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [System.EnvironmentVariableTarget]::Machine)

3. Verify Installation

supabase --version

---

Next Steps: Login and Link Project

1. Login to Supabase

supabase login

This opens your browser for authentication. If it doesn't open automatically:

1. Copy the URL from the terminal

2. Paste it in your browser

3. Click "Authorize CLI"

2. Link Your FleetOS Project

cd C:\Projects\robo-hub
supabase link --project-ref bsbjwjpgiangjqqqxota

When prompted, enter your database password (the one you created when setting up the Supabase project).

3. Verify Link

supabase status

You should see your project details.

---

Deploy WhatsApp Edge Function

Once installed and linked, deploy the function:

# Set Twilio credentials
supabase secrets set TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxx
supabase secrets set TWILIO_AUTH_TOKEN=your-auth-token-here

# Deploy the function
supabase functions deploy send-whatsapp

---

Troubleshooting

"supabase: command not found" after installation

Solution 1: Restart Terminal

• Close PowerShell/CMD completely

• Open new terminal window

Solution 2: Check PATH

# Check if supabase is in PATH
where.exe supabase

# If not found, check installation location
npm root -g
# Should show: C:\Users\YourName\AppData\Roaming\npm\node_modules
# Add to PATH if needed

Solution 3: Use npx (temporary workaround)

npx supabase login
npx supabase link --project-ref bsbjwjpgiangjqqqxota

"Error connecting to project"

• Verify project ref is correct: bsbjwjpgiangjqqqxota

• Check you're using the correct database password

• Ensure you have internet connection

"Access denied" when setting secrets

• Make sure you're logged in: supabase login

• Verify project is linked: supabase status

• Try re-linking: supabase unlink then supabase link

"Function deployment failed"

• Check function code exists: ls supabase/functions/send-whatsapp/index.ts

• Verify no syntax errors in the TypeScript file

• Check deployment logs: supabase functions list

---

Quick Reference Commands

# Installation
npm install -g supabase                          # Install CLI

# Authentication
supabase login                                    # Login to Supabase
supabase logout                                   # Logout

# Project Management
supabase link --project-ref PROJECT_REF          # Link to project
supabase unlink                                   # Unlink current project
supabase status                                   # Show project status

# Edge Functions
supabase functions list                           # List all functions
supabase functions deploy FUNCTION_NAME           # Deploy function
supabase functions delete FUNCTION_NAME           # Delete function

# Secrets Management
supabase secrets list                             # List all secrets
supabase secrets set KEY=VALUE                    # Set secret
supabase secrets unset KEY                        # Remove secret

# Logs
supabase functions logs send-whatsapp             # View function logs

---

Full Setup Script (Copy & Paste)

Once Supabase CLI is installed, run this complete setup:

# Navigate to project
cd C:\Projects\robo-hub

# Login (opens browser)
supabase login

# Link to FleetOS project
supabase link --project-ref bsbjwjpgiangjqqqxota

# Set Twilio credentials (replace with your actual values)
supabase secrets set TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
supabase secrets set TWILIO_AUTH_TOKEN=your-actual-auth-token-here
supabase secrets set TWILIO_WHATSAPP_FROM=whatsapp:[phone]

# Deploy the WhatsApp function
supabase functions deploy send-whatsapp

# View logs (optional)
supabase functions logs send-whatsapp

---

Success Indicators

After deployment, you should see:

✅ supabase login
   → Authenticated successfully

✅ supabase link
   → Linked to project: fleetos-production

✅ supabase secrets set
   → Secret TWILIO_ACCOUNT_SID set

✅ supabase functions deploy send-whatsapp
   → Function URL: https://bsbjwjpgiangjqqqxota.supabase.co/functions/v1/send-whatsapp
   → Deployed successfully!

---

Testing After Deployment

Test with curl

curl -X POST https://bsbjwjpgiangjqqqxota.supabase.co/functions/v1/send-whatsapp `
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." `
  -H "Content-Type: application/json" `
  -d '{\"to\":\"[phone]\",\"message\":\"Test from FleetOS\"}'

Test in Browser

1. Open http://localhost:3000

2. Console: localStorage.setItem('currentView', 'FLEETOS'); location.reload()

3. Click yellow "Test WhatsApp" button

4. Should now show: "Backend API (Production Ready)"

5. Send test message - should work without CORS error!

---

Documentation Links

• Supabase CLI Docs: https://supabase.com/docs/guides/cli

• Edge Functions Guide: https://supabase.com/docs/guides/functions

• GitHub Releases: https://github.com/supabase/cli/releases

• Troubleshooting: https://supabase.com/docs/guides/cli/troubleshooting

---

Need Help?

Check installation:

supabase --version
node --version
npm --version

View detailed help:

supabase --help
supabase functions --help

Check project status:

supabase status