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 emptyProfileName
. 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
andRemotePortForward
specification strings prefixed byL:
andR:
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.
-
AllowSmartHyperlinks
(enumeration)
¶ 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 theSetServerIcon
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 theglobal 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.