Main Content

Troubleshoot Geographic Axes or Chart Basemap Connection

If you choose a basemap other than 'darkwater', the geographic axes or chart retrieves the map data over the Internet. If the axes or chart cannot connect to the map server, then MATLAB® displays an error message such as:

Warning: Unable to access the Internet, showing 'darkwater' where 'colorterrain' is unavailable. See Access Basemaps in MATLAB.

If you have trouble accessing basemaps over the Internet, check your proxy server settings on the MATLAB Web Preferences page. The geographic axes and charts support only non-authenticated and basic authentication types for use with your proxy server.


You can download a selection of basemaps to avoid accessing them over the Internet. See Access Basemaps for Geographic Axes and Charts.

To specify the proxy server settings in MATLAB:

  1. On the Home tab, in the Environment section, click Preferences. Select MATLAB > Web.

  2. Select the Use a proxy server to connect to the Internet check box.

  3. Specify values for Proxy host and Proxy port. Examples of acceptable formats for the host are and ourproxy. For the port, enter an integer only, such as 22. If you do not know the values for your proxy server, ask your system or network administrator for the information. If your proxy server requires a user name and password, select the Use a proxy with authentication check box. Then enter your proxy user name and password.

  4. Ensure that your settings work by clicking the Test connection button. MATLAB attempts to connect to If MATLAB can access the Internet, the word Success! appears next to the button. If MATLAB cannot access the Internet, the word Failed! appears next to the button. Correct the values you entered and try again. If you still cannot connect, try using the values you used when you authenticated your MATLAB license.

  5. Click OK to accept the changes.

To specify system proxy server settings, refer to your Windows documentation for locating the Internet Options control panel. On the Connections tab, select LAN settings. The proxy settings are in the Proxy server section. MATLAB does not consider proxy exceptions which you configure in Windows. Even if you have specified the correct credentials in the MATLAB preference panel or in the Windows system proxy settings, you might see the Proxy Authentication Required error if the proxy server requires an authentication method other than Basic.

See Also

| | | | | | |

Related Topics