How to install SPX-GC

Installation of the pre-built binary version of SPX-GC follows these steps:


Get the most recent application from Older binary versions are listed in the release notes -document, but the use of these is not recommended since newer templates may have features not available in the old version of the application.

If you are interested in running the source code, please see the Github source code repository. This is only recommended for developers who are comfortable with NodeJS technology, npm registry, and git repositories.


Uncompress the zip file to the folder where you want to run the SPX-GC application.

Fix installation issues (Mac and Linux only)

Please note: these issues were fixed in SPX-GC v.1.0.12 (Apr 2021) but instructions are still valid for earlier versions.
  1. Make the file executable. In some instances, the Linux and Mac operating systems may not treat the file as "a program" which prevents execution entirely. See our Knowledge Base -article How to make a file executable

  2. Use installation directory. This is a Mac-specific issue that causes files to generate to users' home-directory and not the "current" directory. See KB article Files generated to a wrong folder on a Mac

First run

During the first run, the application will generate a config.json file with default values and it will also generate folders LOG and DATAROOT to the installation directory. When SPX-GC url is opened in a browser it asks for the password policy.


All global configurations are stored in the config.json file and can be modified with a text editor or from within the SPX-GC > Configuration view.

Please note: the application needs to be restarted whenever changes are done to configuration. If config.json is removed, the application will generate it again with default values at the next start.


Now the application is ready to be used. More more information see other articles in our Knowledge base.