Using Studio From Behind a Proxy


Studio requires an Internet connection to authenticate the user to the Appcelerator cloud on first launch, although the credentials are cached for subsequent use. In addition, the web is used for news, documentation and code updates. This guide explains how to configure it for use behind a proxy.  For Windows systems, use the system proxy settings (see the Windows System Settings section below for details).  

Startup Splash Screen

If no user credentials are available to Studio on launch, a splash screen will be displayed allowing you to enter your user name and password. At the bottom of this dialog, click the Proxy Setup... link to open the following dialog:

The proxy schema (HTTP, HTTPS and SOCKS are all supported), server name or IP address, service port number and authentication details can be configured. After clicking OK, then Login to start, all Internet traffic will be directed via this proxy.

Preferences Window

To configure your proxy settings once Studio has started, open the Preferences window and navigate to Network Connections:

  1. From the menu bar, select WindowsPreferences on Windows, or select Titanium Studio > Preferences or Appcelerator Studio > Preferences on Mac OS X.
  2. Navigate to General > Network Connections.
  3. Select the Proxy entry that you would like to edit, for example, HTTP, and click Edit...
  4. In the Host and Port fields, specify the name or IP address and port number of your proxy server.
  5. If you have authentication enabled, check the Requires Authentication box and type in your proxy User and Password.
  6. Click OK to apply your settings.
  7. Restart Studio. All Internet traffic will be directed via this proxy.

Windows System Settings

For Windows systems, Studio should use the system's proxy settings.  You may need to enter the proxy settings when the Splash Screen appears to get to the Preferences window to change the settings.

  1. From the menu bar, select Windows Preferences.
  2. Navigate to General Network Connections.
  3. Change the Active Provider drop-down to Native.
  4. Click OK to apply your settings.
  5. Restart Studio. All Internet traffic will be directed via the Windows system proxy setttings.

Whitelisting URLs

It's possible you may need to whitelist several URLs in some network environments. Below are the set of URLs to whitelist. If possible, it is easiest to whitelist *

Web access


The port numbers used for the URLs are 80 and 443.

For debugger and profiler, Studio will find a free port for the specific IP address, and it it does not locate one, it will use 8999 as the default. For LiveView, it requires ports 8323 and 8324.

For the local web server that Studio creates, the range of the port Studio looks for is controlled by the preference defined in Preferences > Studio > Web Servers > Built-in. By default the range is 8020-8079.


Related Links