Windows Setup

The Spike Windows download is a standard MSI installer, containing the executable spike.exe and support files. It has no dependencies on other software. There are different ways to set up your application to work with Spike:

  • System-wide proxy — If your client is not based on Java/JVM or you do not have source code, then you can connect the client to Spike by setting the system-wide HTTP proxy in Windows. Microsoft Office applications respect this proxy setting. The Spike MSI installer will create Start Menu entries to run and stop Spike, at the same time enabling and disabling the system-wide proxy. So to start using Spike with an Excel client, for example, simply install Spike and then choose the "Start Spike" option from the Start Menu.
  • Java/JVM — If your client is on JVM (Java, Groovy, etc) and recognizes the Java system flags -Dhttp.proxyHost=localhost -Dhttp.proxyPort=9700, then that will connect your JVM application to Spike. Set the flags and restart your application.
  • HTTP library — If your client is not on JVM and you have access to the client source code, then you can modify your code to proxy through localhost:9700. Most HTTP libraries support a proxy setting. This can often also done by setting an environment variable, instead of requiring a code change. Check the docs for your client's HTTP library.

System-wide proxying

The Spike installer creates entries in the Start Menu to start and stop Spike, and to enable and disable the system-wide proxy. Those operations are all BAT scripts that can be found in the Spike install directory (C:\Program Files (x86)\Spike). If you want to enable the system-wide proxy manually, follow the instructions below.

Setting Windows 10 system proxy manually

Open the Start Menu and click on the Settings app. From there, click on Network and Internet.

Click on the Proxy tab on the left to open the Proxy settings.

  1. Enable the Use a proxy server option, under the Manual proxy setup section.
  2. Enter localhost and 9700 for Address and Port.
  3. Enable the setting "Don't use the proxy server for local (intranet) addresses".
  4. Click Save.

Now network calls should be proxied through Spike at localhost:9700

Setting proxy manually with older version of Windows

For older versions of Windows, you can enable the system-wide proxy through the settings dialog in Internet Explorer.

  • Open Internet Explorer.
  • Open the Tools menu, and click on Internet Options.
  • Open the Connections tab (at the top of the Internet Options pop-up window).
  • Click LAN Settings.
  • Enable the checkbox for "Use a proxy server for your LAN".
  • Enable the checkbox for "Bypass proxy server for local addresses".
  • We want to limit the proxy to HTTP only (not HTTPS), so click the Advanced button.
  • Now you should be in the Proxy Settings pop-up window. Set Address and Port in the HTTP row to localhost and 9700.
  • Disable/uncheck the "Use the same proxy server for all protocols" option. The Secure row should have no proxy settings. This is for HTTPS, which we don't want to proxy (HTTPS is supported by Spike, but requires extra setup).
  • Click OK all the way up, to close Options.

Now network calls should be proxied through Spike at localhost:9700

Note that the steps above for setting the system-side proxy, are done automatically by the "Start Spike" command in the Windows Start Menu.