This was a feature requested by some users due to that since v3.0 some of our servers run behind a load-balancing system, rendering previous workarounds to bypass the proxy settings not valid anymore.
This does not affect you unless you are running Octane behind a proxy. In most cases you'll not even need to do anything special as Octane will try to find the current setup for you and use it.
However, if you are trying to setup your proxy for the first time or your proxy requires authentication we encourage you to read how you may configure it either by using your operating system proxy settings or environment variables.
Proxy configuration via system settings:
This option allows OctaneRender to retrieve your system settings, which configuration depends on your host operating system:
On Windows Octane can obtain its proxy configuration from the following sources:
- From Internet Explorer's LAN Settings: This configuration applies only to the current user. To change IE proxy settings:
inetcpl.cpl ,4and click OK. You will see the Internet Properties window displayed.
- Click LAN Settings.
- Select the Use a proxy server for your LAN check box.
- In the Address box, type the IP address of the proxy server.
- 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.
Proxy exceptions list are currently ignored.
OctaneRender reads the proxy settings stored in the system preferences. To change your proxy settings:
- Open System Preferences.
- Click Network.
- Click Advanced....
- Select the Proxies tab.
- You may choose to enable either Web Proxy (HTTP) or Secure Web Proxy (HTTPS) depending on your proxy type.
- 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.
Proxy authentication through proxy settings is not supported on OSX. If your proxy requires username and password please refer to the following section about proxy configuration via environment variables.
Proxy settings may vary between distributions so proxy configuration on Linux is just supported via environment variables.
Proxy configuration via environment variables:
OctaneRender supports the following proxy environment variables:
https_proxy: Specifies a proxy server for HTTPS network traffic.
all_proxy: Specifies a proxy server for all network traffic.
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 that environment variables are case sensitive, even on Windows, for security reason.
The accepted syntax for proxy environment variables is
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
127.0.1.50as your proxy's address using the default port
80and authenticate as user