Mathematica Internet Connectivity
provides important functionality through accessing the internet. Most Mathematica
functions that provide computable data operate by loading data over the internet. Some functions require real-time access to the internet; others update a local data repository by accessing the internet when required. Mathematica
also requires internet access when you explicitly use Import
to read from a URL, or when you use web services. The Mathematica
documentation system also supports automatic updating via the internet.
When you call a data function like FinancialData
gets the data it needs from the internet. When you click a link to a documentation notebook or call a data function like CountryData
knows whether a newer version of the information is available on a Wolfram Research Paclet Server, and if so it will download and install the update automatically. In the case of smaller paclets like documentation notebooks, this is often so fast that you will not even notice it happening.
acts like a web browser when it accesses the internet, so if you can browse the web from your computer, you should be able to use Mathematica
's internet connectivity features, although in some cases additional configuration may be required.
Internet Connectivity Dialog
The Internet Connectivity
dialog, accessed from the menu, allows you to configure a number of settings related to the paclet system, and Mathematica
's use of the internet in general.
The Allow Mathematica to access the Internet
checkbox can be turned off to prevent Mathematica
from even attempting to use the internet. You will not be able to get load-on-demand updates to documentation, and some data collections functions will not operate.
The Test Internet Connectivity
button is useful to see if Mathematica
is properly configured for internet use. After clicking the button, you should see a dialog within a few seconds (perhaps slightly longer if it fails) reporting success or failure. If the test succeeds, then Mathematica
's internet functionality should work properly. If it fails, consult the "Troubleshooting"
The Proxy Settings
section allows you to specify a proxy server if necessary. In many cases, Mathematica
is able to inherit the proxy settings configured globally for your system or browser. This is the default setting, and most users will leave it as is. If you know that you do not need to go through a proxy server to access the internet, you can click the Direct connection to the Internet
checkbox. You can also manually configure proxy settings if necessary. Contact your system administrator for the values to use. Most users will only need to set the HTTP proxy.
The Automatically check for documentation updates
checkbox and the Automatically check for data updates
checkbox can be turned off to disable load-on-demand updates to documentation and data files. This will not interfere with the operation of Mathematica,
except that you will not receive updates to the documentation or data paclets as they become available.
The Update Local Indices from the Wolfram Research Server
button will cause Mathematica
to read information from the Wolfram Research Paclet Server that describes the versions of the paclets that are available. Mathematica
uses this information to decide whether an update is available to a given resource when you access that resource. Mathematica
reads this information on a weekly basis automatically, but you can force an update using this button. You might want to do this to be sure you will get the absolute latest data from data collections functions like CountryData
Troubleshooting Connectivity Problems
If you get error messages or dialogs that report internet connectivity problems while running Mathematica
, the first thing to do is try the Test Internet Connectivity
button in the Internet Connectivity
dialog, accessible from the menu. If the test succeeds, then Mathematica
is correctly configured for general internet use, and the problem probably lies elsewhere (such as trying to access an incorrect URL). If the test fails, try the following steps:
Test network connectivity by seeing if other programs on your computer can access the internet. For example, launch a web browser and see if it works. If it fails, then the network might be unavailable, or you might have connectivity problems beyond what can be configured in Mathematica
Check proxy settings, as described below.
Check firewall settings, as described below.
Incorrect proxy settings are a common cause of problems with internet connectivity. Many users on a company network cannot directly access the internet, but instead must pass through a proxy server, which acts like a gateway to the internet. By default, Mathematica
will attempt to use system-wide proxy settings, if your operating system has such settings. For example, on Windows, Mathematica
will use the proxy settings configured for Internet Explorer. On Mac OS X, proxy settings are configured in the Network Preferences
's proxy settings are configured in the Internet Connectivity
dialog. The default setting, described above, is Use proxy settings from my system or browser
. If this does not work for you, try the Direct connection to the Internet
choice. If that does not work, then contact your system administrator for proxy settings to enter into the text fields. If you can successfully surf the web with a web browser, you can find its proxy settings dialog and read the values it is using. Many users will only need to set the HTTP proxy.
If your system or browser is configured to get proxy settings from a configuration script, then Mathematica
will not be able to use these settings, and you will have to manually configure its proxy settings.
is configured to Use proxy settings from your system or browser
, and your browser functions but Mathematica
cannot connect, see if your system proxy settings have a Use same proxy server for all protocols
checkbox and try unchecking it. Mathematica
will attempt to use a SOCKS proxy if one is set, and if your HTTP proxy does not also handle SOCKS traffic, Use same proxy server for all protocols
is not a correct setting for your system. An incorrectly configured SOCKS proxy can cause very long timeouts, so if the Test Network Connectivity
button fails after a minutes-long delay, an incorrect SOCKS proxy configuration is likely the problem. Mathematica
does not require a SOCKS proxy, so the SOCKS Host
field can be left blank, but if you supply a value, either manually or via the system setting Use the same proxy server for all protocols
, it must be correct.
acts like a web browser when it accesses the internet, most company firewalls will not interfere with it. Some users, however, have so-called "personal" firewalls on their machines (ZoneAlarm, Norton, etc., or the one built into Microsoft Windows). If configured with strict settings, these firewalls might interfere with Mathematica
's attempts to use the internet.
These types of firewalls will generally display a dialog box warning you that a program is trying to use the internet and allow you to accept or reject it. If you see such a dialog, it might report that the program is the Mathematica
kernel or the Java Runtime Environment that is bundled in the Mathematica
layout. Configure the firewall to always allow such requests.
If the information in this document is not sufficient to help you solve connectivity problems, consult the Wolfram Research Technical Support troubleshooting guide at http://support.wolfram.com/mathematica/systems/allplatforms/networkconnectivityissues.html