server Server Configuration

The server config file is located in ~/.winswitch/server/server.conf on *nix, *\Application Data\Window-Switch\server\server.conf on MS Windows.
It will be generated automatically when you run winswitch_server for the first time.

Sensible default values may be specified for the whole server in the file /etc/winswitch/server_defaults.conf (Unix-like only), which may contain any of the values documented below, except for the unique identifier ID and the encryption keys as those must be unique to each server instance.

Most options should be self explanatory and can be overriden from the command line using "--OPTION_NAME=VALUE"
(or more simply "--OPTION_NAME" or "--no-OPTION_NAME" for boolean types)
For example, you can start the server with "winswitch_server --debug-mode" to enable debugging.

Here is an annotated configuration file:


# Window Switch Configuration File

# The unique ID which is used to identify this server
ID="13113210055"
name="main-desktop"
type="workstation"

# Which interface(s) and port(s) the server will listen on. (see FAQ for more details)
listen_on="*:"

# Various paths which should have been populated automatically:
nxagent_command="/usr/bin/nxagent"
xpra_command="/usr/bin/xpra"
xpra_xvfb_command="/usr/bin/Xvfb -nolisten tcp +extension Composite -screen 0 3840x2560x24+32 -auth $XAUTHORITY"
pulseaudio_command="/usr/bin/pulseaudio"
xvnc_command="/usr/local/bin/Xvnc"
firewall_script="winswitch_firewall"
default_open_command="winswitch_open"
ssh_host_public_key_file="/etc/ssh/ssh_host_rsa_key.pub"
browse_command="thunar ~/Desktop/"

# Whether we require the clients to connect via SSH (useful for getting through a firewall)
ssh_tunnel=False
# Whether this ssh server supports X11 display forwarding (X11Forwarding option)
supports_ssh=True
# Whether this server supports printer/sound/file forwarding/sharing
tunnel_printer=True
tunnel_samba=False
tunnel_sound=True

# If this is set to True, the "firewall_script" will be called to try to grant/revoke access with the firewall
firewall_enabled=False

# Advertise this server via multicast-DNS (for use on a LAN)
mDNS_publish=True
mDNS_publish_username=True

# This is safer
allow_root_logins=False

# Prints debug information to the terminal/logfile
debug_mode=True

# Enables session-preloading for faster session startup
prelaunch_enabled=True

# The cryptographic key which identifies this server (trimmed):
crypto_public_exponent=65537
crypto_private_exponent=2033236416667875172011566243924689410639700000
crypto_modulus=227416143357959066027446525118770471217361088752257602815637
key_fingerprint="65afae015a2c61ebc3e0abedf27e2e1d871a1f12"

# Options for the Xvnc server
xvnc_options[0]=+extension
xvnc_options[1]=RANDR
xvnc_options[2]=-once
xvnc_options[3]=+kb
xvnc_options[4]=-br

# List of commands which should not be shown in the start menu (trimmed):
ignored_commands[0]=compiz
ignored_commands[1]=alltray

# Command used for capturing screenshots:
screen_capture_command="/usr/bin/xwd -root -silent | /usr/bin/xwdtopnm | /usr/bin/pnmscale -reduce 8 | /usr/bin/pnmtopng > "