Skip to content
Try Now

Back to Articles

FastX.conf

Update to date information can be found by logging into your current FastX server via a browser and go to /help. (https://example.com:3300/help)

The FastX.conf file is a special file that is located in $FX_CONFIG_DIR. This file sets special variables for launching sessions.  These are the default paths where the session will store session information.

# HOST is set to $(hostname) by default
# override the DNS hostname
# HOST is used in the history file, to make an X11 authorization entry, and to set the DISPLAY name
HOST=customhost.example.com

# base directory for FastX user storage
# stores user history, apps and favorites when not running the web server
# if this directory cannot be created, history will not be saved
FastXPath=@HOME@/.fastx_server

# location of session directories
# A session directory is named “FX3-” followed by the session id
# The session directory contains log files, the X11 authorization file, session parameters, process ids, and other session-specific files
SessionPath=@HOME@/.fastx_server/@HOST@/sessions

File Format

  • The file is a list of key=value pairs, one per line
  • A # makes the rest of the line a comment.
  • Variable expansion is done by enclosing the variable name in “@” (@VAR@).
    • A variable can be either a FastX.conf variable or an environment variable.
    • Available variables
      • HOST: set to the hostname of this server 
      • USER: username
      • HOME: home directory environment variable.
  • To put a literal @ in a variable, use @@
  • To put a literal # in a variable, use @#@