Skip to content
Proxy

Network

OpenCode supports standard proxy environment variables and custom certificates for enterprise network environments.

OpenCode respects standard proxy environment variables.

Terminal
# HTTPS proxy (recommended)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP proxy (if HTTPS not available)
export HTTP_PROXY=http://proxy.example.com:8080

# Bypass proxy for local server (required)
export NO_PROXY=localhost,127.0.0.1

You can configure the server’s port and hostname using CLI flags.

If your proxy requires basic authentication, include credentials in the URL.

Terminal
export HTTPS_PROXY=http://username:password@proxy.example.com:8080

For proxies requiring advanced authentication like NTLM or Kerberos, consider using an LLM Gateway that supports your authentication method.

If your enterprise uses custom CAs for HTTPS connections, configure OpenCode to trust them.

Terminal
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

This works for both proxy connections and direct API access.