Server

Server settings are named settings objects stored at $HOME/.config/qtermy/server. Servers can be edited from the Server menu, Manage Servers window, and various context menus, or by calling the EditServer action. The files can also be edited directly in a text editor, but note that qtermy does not monitor for external changes to settings files. Use the reload files button in the Manage Servers window to load external changes without restarting the application.

A server is an instance of termy-server running as a certain user on a certain machine. The local servers are those server instances running alongside qtermy as the same user, with one of them, the transient local server, launched as a private child process of qtermy itself.

A server is made accessible to qtermy by opening a connection.

Server settings are named after the unique identifier of the server that they reference. When a server is seen for the first time by qtermy, a new server settings object with default settings will be created to track it. In addition to storing user preferences for each server, server settings objects also store various state information about the server.

Settings Categories

Server

StartupProfiles (stringlist)

Terminals to be created automatically on the server at connection time. This is a list of profiles, each of which will be applied to a new terminal on the server upon connection. The special profile name <Default> indicates the current global default profile.

If the server already has existing terminals with matching profiles, new terminals will not be created with those profiles. A terminal's existing profile is determined by the value of the profile terminal attribute.

DefaultProfile (string)

The default profile to use when creating terminals on the server. This profile will be used when NewTerminal is called with an empty ProfileName. If this setting is empty, the global default profile will be used.

PortForwardingRules (stringlist)

Saved port forwarding tasks which can be either started on demand from the Manage Port Forwarding window or started automatically at server connection time. Click the Ports button to bring up a Port Forwarding Editor.

The list itself consists of LocalPortForward and RemotePortForward specification strings prefixed by L: and R: respectively. The prefix letter is upper case for automatic tasks, lower case otherwise.

RenderInlineImages (enumeration)

See the RenderInlineImages global setting. This setting can be used to override the global setting on a per-server basis.

See the AllowSmartHyperlinks global setting. This setting can be used to override the global setting on a per-server basis.

Appearance

FixedThumbnailIcon (string)

Specifies a custom icon which will be displayed on the server thumbnail in the Terminals tool, in context menus, and in the Manage Servers window, overriding the icon server attribute normally used to select the icon. This can also be done using the SetServerIcon action. Refer to that action for more information.

Files

DownloadLocation (string)

The default folder in which to store files downloaded from this server. This setting can be used to override the global setting on a per-server basis.

DownloadFileConfirmation (enumeration)

See the DownloadFileConfirmation global setting. This setting can be used to override the global setting on a per-server basis.

UploadFileConfirmation (enumeration)

See the UploadFileConfirmation global setting. This setting can be used to override the global setting on a per-server basis.

DeleteFileConfirmation (enumeration)

See the DeleteFileConfirmation global setting. This setting can be used to override the global setting on a per-server basis.

RenameFileConfirmation (enumeration)

See the RenameFileConfirmation global setting. This setting can be used to override the global setting on a per-server basis.

State

The following server state information is saved automatically under this category:

  • The date and time of last contact with the server.
  • The username, hostname, network address, and icon attributes last reported by the server.
  • The name and type of the connection on which the server was last seen.

This information is displayed in the Manage Servers window.