FastX Configuration Overview


FastX is highly configurable to meet the needs of individual users and corporations alike.  By configuring files, IT managers can turn FastX into a Gateway Servers, or Clusters, or perform management tasks like creating administrators or monitoring login attempts.

NOTE:
The GUI configuration changes files on the system running the web server only.
The  system administrator can copy over the configurations (by default located in /usr/lib/fastx2/config/ )to other systems as needed.

System Configuration GUI

The Web Client has a GUI that simplifies configuration of the FastX System.  In general, system administrators should use the GUI to change files.

  1. Log in the the Web Interface as an Administrator
  2. Click on username@hostname > System Configuration
  3. Change the settings as needed

 

Themes

Configuration for changing the theme colors/logo

Admins

Configuration for creating admins

Sessions

Session

Configuration to change the server options (memory, openGL, TCP etc) for new sessions.

Bookmarks

Configuration for server side suggestions

Commands

Configuration for blacklisting commands when starting a session

Network

www

Configuration for settings up the web server

Settings

Configuration for general web server settings

Configuration

Configuration to change the network configuration of the server (Cluster, gateway, session server).

Configuration Files

The following is an overview of the configuration files and their purpose. Unless otherwise stated, the file are in valid json format and located in /usr/lib/fastx2/config on a default installation. Use a  JSON Validator to verify that the syntax is correct.

www.json

Configuration for setting up the web server.

settings.json

General configuration for server side settings

client.json

Client hints for the UI

session.json

Configuration File for Xrdp sessions

suggestions.json

Configuration of server side suggestions

network.json

Configuration for creating gateways and clusters

command.json

Configuration for commands to allow or deny when starting sessions

admin.json

Configuration file to enable admins

fastx-defaults.json

Configuration of the web client’s default settings.

theme.json

Configuration file that holds the FastX theme (colors/logo etc)

 

session-server.json (deprecated in 2.2: use network.json)

Configuration file to create a session server when FastX is running in Gateway or Cluster configuration

gateway-server.json (deprecated in 2.2: use network.json)

Configuration file to create a gateway server when FastX is running in Gateway or Cluster configuration

command.allow (deprecated in 2.2: use command.json)

File containing commands on the whitelist.  FastX will only launch sessions that pass the whitelist test.  This file has its own custom syntax

command.deny (deprecated in 2.2: use command.json)

File containing commands on the blacklist.  FastX will refuse to launch sessions that are on the session blacklist. This file has its own custom syntax