Factors that could prevent your VPN from working

-Eclipse VPN is designed to only operate in Iran and with an Iranian IP address. If you travel outside Iran, Eclipse VPN will no longer operate. If you are in Iran, make sure you are not using a proxy or another VPN that will alter the device’s IP address to another country.

-Please make sure your device is able to access the Internet. In the device settings page make sure Wifi/Mobile data is on. Then, check to make sure the Internet can be accessed using a web browser without using Eclipse VPN.

-Please check if another VPN is already running on your device. If so, disable that VPN before activating Eclipse VPN.

-If steps above don’t allow Eclipse VPN to function, please try restarting your device.

Special Cases

Always-On VPN (Android 7+):

A region must be first selected within the Eclipse VPN app before you can use the Always-On VPN feature on your device


-If you are getting the “Unable to connect to proxy – Please check your proxy settings and try again” message in the proxy settings screen, please make sure you are on the same network as your proxy server.

-If you want to connect to a local proxy app on your device (i.e. Shadowsocks etc.), please make sure your local proxy app is configured correctly and already connected before trying to connect to it in the Eclipse VPN proxy settings page. In the Hostname or IP Address text field, please make sure to enter localhost or

Split Tunnel:

If you are using the split tunnel feature, but the apps that are excluded from the VPN are not making a connection, please make sure you do not have “Always block connections without VPN” enabled in your device’s setting menu. Note: Always block connections without VPN is available only on devices that use Android v8 and above.

Internet Sharing:

If you are connecting via Bluetooth Sharing/Mobile Hotspot, please make sure Internet sharing is activated on your host device.

Oppo Phones:

Normally if Eclipse VPN is connected and the Eclipse VPN app is terminated by the user or the system, the connection will persist. On Oppo ColorOS devices, shutting down the Eclipse VPN app will disconnect the VPN due to restrictions on this device.

Known Affected Phones:

Oppo R11s, ColorOS v3.2, Android v7.1.1

Oppo AX5s, ColorOS v5.2.1, Android v8.1.0