Connection Issues
Experiencing connectivity issues with Workshop? This guide helps you troubleshoot and resolve network or firewall-related problems.Required Connections
To function correctly, Workshop needs access to several services. Ensure the following domains are accessible if you are on a restricted network:| Domain/Service | Purpose | Port | Protocol |
|---|---|---|---|
*.workshop.ai | Core service communication | 443 | HTTPS |
*.googleapis.com | Session management | 443 | HTTPS |
*.us-central1-memex-desktop.cloudfunctions.net | AI model access | 443 | HTTPS |
*.memexpublic.blob.core.windows.net | Updates and announcements | 443 | HTTPS |
*.openaipublic.blob.core.windows.net | OpenAI services | 443 | HTTPS |
*.api.github.com | Template resources | 443 | HTTPS |
*.us.i.posthog.com | Telemetry | 443 | HTTPS |
*.sentry.io | Error reporting | 443 | HTTPS |
*.lemonsqueezy.com | Payment processing | 443 | HTTPS |
Some infrastructure domains reference legacy naming (e.g.,
memex-desktop.cloudfunctions.net). These are real domains that Workshop’s backend relies on — they must be allowlisted even though the product is now called Workshop.Identifying Connectivity Issues
You may have network issues if:- You cannot start or send messages in Workshop
- You encounter error messages about connection failures
- You experience delayed responses or timeouts
Troubleshooting Steps
Check your internet connection
Verify your device is online by visiting other websites in your browser.
Check firewall restrictions
If you are behind a corporate firewall, request IT to allowlist the domains listed above. For personal firewalls, check settings to allow Workshop access.
Test VPN interference
Temporarily disable your VPN to test connectivity. If that resolves the issue, adjust VPN settings to allow traffic to the necessary domains.
Testing Your Connection
Verify network access from a terminal:SSL Intercept Issues (Proxy)
If you see an error like:- Obtain the proxy’s CA certificate — this is usually a
.pemor.crtfile from your IT department - Install the CA certificate system-wide:
- macOS: Add it to the “System” keychain in Keychain Access and set trust to “Always Trust” for SSL
- Windows: Import into the “Trusted Root Certification Authorities” store for “Local Computer”
- Linux: Place the
.crtfile in/usr/local/share/ca-certificates/and runsudo update-ca-certificates
Upgrading Workshop
Many connectivity issues are resolved by upgrading to the latest version. Visit workshop.ai to download the latest release, or check the announcements section within the application.Need More Help?
If issues persist:- Document your network setup details (firewall type, proxy configuration, VPN provider)
- Capture any error messages you see
- Contact Workshop support with this information:
- Email: help@workshop.ai
- Discord: Join our community