HTTP Proxy Support


If you are running Octane behind an existing proxy, Octane will try to find the current setup of your proxy and use it. Workarounds to bypass the proxy settings will not be valid.

If you are trying to setup your proxy for the first time or your proxy requires authentication, you may configure it either by using your operating system proxy settings or environment variables.


Proxy ServerA Proxy Server, also known as an application-level gateway, is an intermediary server between the local network and the external servers from which a client is requesting a service. The external servers will only see the network proxy server's IP address thus providing some degree of security and privacy. There are various kinds of proxies, the most common are Web Proxies. configuration via system settings

This option allows OctaneRender to retrieve your system settings, the configuration will depend on your host operating system:


For Windows:

On Windows Octane can obtain its proxy configuration from the following sources:

  1. Press Win+R keys.
  2. Enter inetcpl.cpl ,4 and click OK. You will see the Internet Properties window displayed.
  3. Click LAN Settings.
  4. Select the Use a proxy server for your LAN check box.
  5. In the Address box, type the IP address of the proxy server.
  6. In the Port box, type the port number.

If you have a dedicated proxy for HTTPS traffic, click on Advanced, uncheck Use the same proxy for all protocols and specify proxy address and port for the Secure server type.

From the WinHTTP configuration: This configuration is system-wide and usually stored in the registry. It can be managed using "netsh winhttp". For more information, please check Windows HTTP documentation from Microsoft.

The proxy exceptions list is currently ignored.


Mac OSX:

OctaneRender reads the proxy settings stored in the system preferences. To change your proxy settings:

  1. Open System Preferences.
  2. Click Network.
  3. Click Advanced ...
  4. Select the Proxies tab.
  5. You may choose to enable either Web proxy (HTTP) or Secure web proxy (HTTPS) depending on your proxy type.
  6. In the Web proxy server section, type the IP address of your server and port number.

Bypass proxy settings are currently not used by Octane.

Port numbers will default to 80 if using HTTP and 443 if using HTTPS if none is explicitly specified.

The proxy authentication through proxy settings is not supported on MAC systems. If your proxy requires username and password, please refer to the following section about proxy configuration via environment variables.



The proxy settings may vary between distributions so proxy configuration on Linux is just supported via environment variables.

The proxy configuration via environment variables:

OctaneRender supports the following proxy environment variables:

These are commonly used environment variables for specifying proxy configuration, specially on Linux. From Octane's perspective it's really up to you which one you decide to use, just take into account that this may affect other applications which may also make use of them.

If one of these variables if found this will override your system's proxy preferences even if there's a configured proxy already.

Note: Environment variables are case sensitive, even on Windows, for security reasons.

The accepted syntax for proxy environment variables is [protocol://][user:password@]proxyhost[:port]

As a way of example, you may expecify a proxy for HTTPS network traffic as https_proxy=johndoe:[email protected]. This will tell Octane to use as your proxy's address using the default port 80 and authenticate as user "johndoe" with password "mypass".