Skip to main content
The upgrade command opens a Polar checkout session to subscribe to Sher Pro at $8/month.
This command requires authentication. Run sher login first.

​
Usage

sher upgrade

​
What Happens

  1. Sher creates a checkout session with Polar (payment processor)
  2. Your browser opens to the checkout page
  3. You complete payment
  4. Your account is upgraded to Pro
  5. Higher limits take effect immediately

​
Example Flow

sher upgrade

  sher — upgrade to Pro

  Creating checkout session...

  Opening Polar checkout in your browser...
  If it didn't open, visit:

  https://polar.sh/checkout/abc123xyz
Your browser will open to the Polar checkout page where you can:
  • Enter payment details
  • Review subscription terms
  • Complete the upgrade

​
Pro Benefits

Upgrading to Pro unlocks:
​
Links per day
number
200 links/day (vs 25 on free tier)Create more preview links for larger teams or frequent deployments.
​
Max upload size
number
100MB (vs 50MB on free tier)Upload larger projects with more assets, images, and dependencies.
​
Max TTL
number
168 hours (7 days) (vs 24 hours on free tier)Keep preview links active for an entire week.
sher link --ttl 168  # 7-day link
​
Password protection
boolean
Enabled (not available on free tier)Protect your previews with passwords.
sher link --pass
sher link --pass mySecretKey

​
Pricing

PlanPriceLinks/DayUpload SizeMax TTLPassword
Starter (Free)$02550MB24h❌
Pro$8/mo200100MB168h✅
Pro is billed monthly through Polar. Cancel anytime.

​
Not Logged In

If you try to upgrade without authenticating: 
sher upgrade

  Login required. Run `sher login` first.

​
Browser Not Opening?

If your browser doesn’t open automatically, copy the URL shown in the terminal: 
  Opening Polar checkout in your browser...
  If it didn't open, visit:

  https://polar.sh/checkout/abc123xyz

​
After Upgrading

Once you’ve completed payment:
  1. Close the browser tab
  2. Verify your tier with sher whoami:
sher whoami

  Logged in as octocat
  tier       Pro
  1. Start using Pro features:
# Longer TTL
sher link --ttl 168

# Password protection
sher link --pass

# Larger uploads (up to 100MB)
sher link

​
Managing Your Subscription

To manage your Pro subscription:
  1. Visit Polar
  2. Log in with your GitHub account
  3. Manage billing, update payment method, or cancel subscription

​
Canceling Pro

If you cancel your Pro subscription:
  • You’ll retain Pro access until the end of your billing period
  • After that, you’ll be downgraded to Starter (Free)
  • Existing deployments remain active until they expire
  • You can re-subscribe anytime

​
Use Cases

​
Frequent deployments

If you’re hitting the 25 links/day limit: 
sher whoami  # Check current tier
sher upgrade  # Upgrade to 200/day

​
Large projects

If your build output exceeds 50MB: 
sher link
# Error: Build output is 55.2MB (max 50MB)

sher upgrade  # Unlock 100MB uploads
sher link  # Now works

​
Long-lived previews

Share previews that need to last more than 24 hours: 
sher upgrade
sher link --ttl 168  # 7-day link

​
Private previews

Password-protect sensitive work: 
sher upgrade
sher link --pass clientPassword123

Build docs developers (and LLMs) love

Get started for freeTalk to us