Installing on Linux

When upgrading, if there is a running instance of SpectX Server on the machine, it must be stopped first by executing command bin/ stop in case it is running as a daemon in background, or by terminating the corresponding process if it is running in console in foreground.

The following steps must be performed for installing SpectX Server on Linux or Arch Linux ARM.

user@host:~$ tar -zxf spectx-v{version}-{platform}.tar.gz
user@host:~$ cd spectx
user@host:~/spectx$ bin/ start
  1. Download SpectX for your platform (linux64 or aarch64).
  2. Open the command-line and unpack the compressed file.
  3. Navigate to the unpacked directory spectx/.
  4. Start the SpectX server process by executing bin/ start.

See also

other arguments of startup script

Upon its very first run, SpectX will ask several questions to define user access and privileges, network and cache settings, and password for the default admin user. Press Enter to accept the default settings, or customise as desired.

Service interface (                           []:
Service port (wgui.port)                                [8388]:
File access policy (engine.da.protocol.file)            [managed]:
Create local cache (sx.pu_data.cache.enabled)           [false]: true
Cache directory (sx.pu_data.cache.dir)                  [${SPECTX_HOME}/pudata/cache]:
Cache max size (sx.pu_data.cache.max_size), 0=unlimited [0GB]:
New password for user 'admin' (min length 8 symbols)    :
New password for user 'admin' again                     [*********]:

Configuration saved to /......./spectx/conf/sx.conf

The SpectX web interface is at

These questions define:

  1. Defines the IP address or hostname of the SpectX server process:

    Default value=


SpectX may override this setting during the activation process. The Free license allows using SpectX Server Edition only at localhost (

  1. Defines the port that SpectX is listening on:

    Default value=8388

  2. Defines the access mode to local file system for all SpectX users. See Protecting Access to Local Data for details.

    Default value=managed


SpectX may override this setting during the activation process. The Free license does not allow access control.

  1. Defines whether or not SpectX creates a local data cache. SpectX can create a local data cache of its most frequently accessed data, this function improves subsequent query speeds and reduces network resource consumption.

    Enter true to give SpectX permission to create a cache. If a cache is created Spectx prompts to define the locations and data constraints of the cache. The location of the data cache can also be defined to secondary or external storage which further optimises passing times.

    Default value=false

  2. Defines password for user ‘admin’.


SpectX may override this setting during the activation process. The Free license allows only unauthenticated single user mode, therefore the ‘admin’ user and specified password are ignored.

After the initial setup administrators can further customise SpectX to meet the security requirements of their own organizations and users. For information on all additional settings see securing.

Once the initial setup is complete, then open a web browser and navigate to the URL displayed in the last line after the first run (default: and log in to SpectX WUI using the default user name admin and the password submitted during setup:

  1. Accept EULA:
  1. Activate SpectX

Installation Directories

During the first run, SpectX creates its configuration file conf/sx.conf based on the content of configuration template file conf/sx.conf.default and the user input provided to configuration questions. It also creates environment variables definition file bin/ based on template file bin/ Also, it creates directories data/ (resource tree) and pudata/ (query processing related data), logs/ (own logs) and a user database file sxwgui.db. The layout of the spectx/ directory becomes as follows:

└── spectx/
    ├── bin/
    │   ├──               : script for launching SpectX from commandline
    │   ├──           : copied from on first run
    │   └──   : default env variable definitions template
    ├── conf/
    │   ├── sx.conf                 : created from sx.conf.default on first run
    │   └── sx.conf.default         : default configuration template
    ├── data/                       : SpectX user data (resource tree)
    ├── jre/                        : Java runtime
    ├── lib/                        : SpectX binaries
    ├── logs/                       : SpectX logs
    ├── pudata/                     : cache, temporary files, etc
    └── sxwgui.db                   : database containing SpectX user role definitions

Note that the files conf/sx.conf and bin/ will not be modified or deleted during the updates in the future.