Troubleshooting
Troubleshooting
Common issues and fixes for ZYBER.
Never share your private key or seed phrase. Support will only ever ask for your public wallet address.
Quick checks (do these first)
Wallet connection issues
Wallet not detected
"No wallet found" message
Install Phantom, Solflare, or Backpack browser extension.
Wallet installed but not detected
Refresh the page. Ensure the extension is enabled.
Multiple wallets conflicting
Disable other wallet extensions temporarily.
Mobile wallet issues
Use the wallet in-app browser, or install the ZYBER PWA.
Signature fails
Signature request times out
Check wallet popup wasn't blocked. Try again.
"User rejected" error
You canceled the signature. Try again and approve.
Signature verification fails
Disconnect wallet. Clear cache. Reconnect.
Hardware wallet timeout
Increase timeout in wallet settings. Keep device unlocked.
Wrong network
Transaction fails with network error
Switch to Solana Mainnet in wallet settings.
"Invalid network" message
Ensure wallet is on mainnet, not devnet.
Workspace issues
Workspace won't start
"Insufficient credits"
Balance too low
Purchase more credits.
Stuck on "Starting..."
Backend delay
Wait 30 seconds. Refresh if still stuck.
"Resource unavailable"
High demand
Try another tier, or wait and retry.
Repeated failures
Account issue
Contact support with your public wallet address.
Slow performance
Laggy typing
Network latency
Check internet. Try a closer region.
Slow builds
Insufficient resources
Upgrade to a higher tier.
Disk I/O slow
Storage limits
Clear unused files. Check disk usage.
High memory usage
Memory pressure
Upgrade tier, or close unused processes.
Connection dropped
"Connection lost" message
Check internet. Refresh the page.
Frequent disconnections
Disable VPN/proxy. Check firewall rules.
Reconnect fails
Clear browser cache. Try another browser.
WebSocket errors
Check if a corporate firewall blocks WebSockets.
Terminal issues
Terminal not responding
Press Ctrl+C to cancel a stuck command.
Can't type in terminal
Click inside the terminal to focus.
Terminal shows garbage characters
Run reset then press Enter.
Copy/paste not working
Use Ctrl+Shift+C/V or the right-click menu.
Credit issues
Credits not appearing
Transaction confirmed but no credits
Wait 30 seconds. Refresh the dashboard.
Transaction pending
Wait for Solana confirmation (usually instant).
Wrong amount received
Check transaction details. Contact support if mismatch.
Transaction failed
Check wallet error. Ensure enough SOL for gas.
Transaction failed
"Insufficient balance"
Not enough SOL/USDC
Add funds to the wallet.
"Transaction simulation failed"
Network congestion
Wait and retry.
Gas estimation failed
Wallet issue
Update wallet. Try again.
Timeout error
Network issues
Retry with a higher priority fee.
Billing questions
Charged while paused?
Paused workspaces incur storage costs only. No compute costs.
Credit discrepancy?
Check transaction history. Compare with workspace usage.
Double charged?
Check the explorer. Contact support with tx hashes.
AI integration issues
API key errors
"Invalid API key"
Verify the key. Check it wasn't rotated.
"Unauthorized"
Check the key has required permissions.
Key not saving
Click Save. Refresh and re-enter.
Rate limit errors
Reduce request rate. Upgrade provider plan.
AI not responding
Timeout errors
Provider overloaded
Retry. Or try a different provider.
Empty responses
Malformed request
Check prompt format.
Connection refused
Provider down
Check the provider status page.
Git issues
Authentication failed
"Permission denied (publickey)"
Add an SSH key to GitHub/GitLab.
Token rejected
Generate a new personal access token.
"Repository not found"
Check the URL. Verify you have access.
SSL certificate error
Update git: apt update && apt install git.
Push/pull fails
"Non-fast-forward"
Pull first: git pull --rebase.
Large file rejected
Use Git LFS or remove large files.
Timeout on large repos
Use shallow clone: git clone --depth 1.
Browser issues
Display problems
Blank screen
Disable ad blockers. Try incognito mode.
UI elements missing
Clear cache. Hard refresh: Ctrl+Shift+R.
Fonts look wrong
Enable web fonts in browser settings.
Scrolling issues
Try a different browser.
Performance
Browser freezing
Close other tabs. Check memory usage.
High CPU usage
Disable extensions. Try a different browser.
Video stuttering
Lower quality in settings. Check bandwidth.
Network issues
Corporate/school networks
WebSocket blocked
Ask IT to whitelist *.zyber.app.
Proxy interference
Bypass proxy for zyber.app.
SSL inspection breaking connection
Add zyber.app to SSL inspection exceptions.
VPN conflicts
Can't connect with VPN on
Use split tunneling to exclude zyber.app.
Slow with VPN
Disable VPN while using ZYBER.
Getting more help
If this didn’t fix it, send us details we can act on.
Check the status page:
status.zyber.app.Join Discord:
discord.gg/zyber.Email:
[email protected]with:Your public wallet address.
Browser and OS version.
Screenshot of the error.
Exact steps to reproduce.
Last updated