Skip to main content

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/ServicePurposePortProtocol
*.workshop.aiCore service communication443HTTPS
*.googleapis.comSession management443HTTPS
*.us-central1-memex-desktop.cloudfunctions.netAI model access443HTTPS
*.memexpublic.blob.core.windows.netUpdates and announcements443HTTPS
*.openaipublic.blob.core.windows.netOpenAI services443HTTPS
*.api.github.comTemplate resources443HTTPS
*.us.i.posthog.comTelemetry443HTTPS
*.sentry.ioError reporting443HTTPS
*.lemonsqueezy.comPayment processing443HTTPS
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

1

Check your internet connection

Verify your device is online by visiting other websites in your browser.
2

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.
3

Check proxy server settings

Verify your proxy allows connections to the required services.
4

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.
5

Check DNS configuration

Try alternative DNS servers such as 8.8.8.8 (Google) or 1.1.1.1 (Cloudflare). Flush your DNS cache to update records.

Testing Your Connection

Verify network access from a terminal:
# Ping the main Workshop domain
ping workshop.ai

# Test HTTPS connection
curl -I https://workshop.ai
Repeat for other required domains if needed.

SSL Intercept Issues (Proxy)

If you see an error like:
ConnectError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify
failed: self-signed certificate in certificate chain
This typically means a corporate proxy is intercepting SSL traffic. To resolve:
  1. Obtain the proxy’s CA certificate — this is usually a .pem or .crt file from your IT department
  2. 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 .crt file in /usr/local/share/ca-certificates/ and run sudo 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:
  1. Document your network setup details (firewall type, proxy configuration, VPN provider)
  2. Capture any error messages you see
  3. Contact Workshop support with this information:
Network configurations vary widely between organizations. Your IT department may need to implement specific solutions for your environment.