Skip to content

SSH Config File

Synced through iCloud

If you have enabled iCloud inside WebSSH your SSH Config File will be synced on all your devices.

Configuration Overwrite

When you define a SSH Config File inside WebSSH, it will overwrite the default configuration you have done inside each matched connections.

For example, if you have defined a SSH Config File with a RemoteCommand but you have already defined a RemoteCommand inside a connection, the connection RemoteCommand will be overwritten by the SSH Config File RemoteCommand.

This overwrite only happens when launching a connection. If you edit a connection, you won't see the SSH Config File values.

Since WebSSH 20.6 you can setup a SSH Config File in order to define default values for your connections.

In order to edit the WebSSH SSH Config File just need to :

  1. Open WebSSH Settings ⚙
  2. Scroll to "SSH" settings section
  3. Edit /etc/ssh/ssh_config

Supported Features 1

Keyword Type Expected value Since Example usage
Ciphers String List of ciphers to use. Comma separated 27.4 See Ciphers
Host String Connection name (aka alias) pattern. See below for examples. 20.6 Host MY_SERVER_NAME
HostKeyAlgorithms String List of host key algorithms to use. Comma separated 27.4 See HostKeyAlgorithms
Hostname String Connection host 20.6 Hostname my.host.com
KexAlgorithms String List of key exchange algorithms to use. Comma separated 27.4 See KexAlgorithms
MACs String List of MACs to use. Comma separated 27.4 See MACs
Port Integer Connection port 20.6 Port 2222
RemoteCommand String The command to launch instead of requesting a default Shell 20.6 RemoteCommand /bin/bash
SetEnv String Environment variable to set 23.6 SetEnv MY_ENV="Awesome!"
User String Connection user 20.6 User myuser

Host Patterns

ℹ️ New in WebSSH 29.6: You can now use regular expressions in Host patterns by wrapping them with slashes.
This allows advanced matching beyond the standard * and ? wildcards.

  • Patterns without slashes behave like OpenSSH (*, ?, !)
  • Patterns wrapped in /.../ are treated as full regular expressions
  • ! still works to exclude matching hosts

⚠️ Be sure to escape special regex characters like . or + when needed.

Standard wildcard pattern

Host *.example.com
    User defaultuser

Regex pattern: matches prod-01.example.com, prod-99.example.com, etc.

Host /^prod-[0-9]+.example.com$/
    User deploy

Negated regex pattern: excludes test-* hosts

Host !/^test-.*/
    User production

Insensitive regex pattern: matches both prod-01.example.com and PROD-01.EXAMPLE.COM

Host /(?i)^prod-[0-9]+.example.com$/
    User deploy

Special Features

All special features are prefixed by #! and are not part of the SSH Config File specification.

Keyword Type Expected value Since Example usage
#!BackgroundColor String Terminal background color. Any CSS value. 22.4 #!BackgroundColor pink
#!BadgeColor String Terminal badge color. Any CSS value. 29.6 #!BadgeColor red
#!BadgeContent String Terminal badge content. Any text value. 29.6 #!BadgeContent "My Server - Production"
#!BadgeFontSize Integer Terminal badge font size in pixels. 29.6 #!BadgeFontSize 14
#!BadgePosition String Terminal badge position. Possible values : top-left, top-center, top-right, bottom-left, bottom-center, bottom-right 29.6 #!BadgePosition top-right
#!ColorTheme String Terminal color theme. Possible values : any valid theme name 24.5 #!ColorTheme "GITHUB DARK"
#!CursorColor String Terminal cursor color. Any CSS value. 22.4 #!CursorColor magenta
#!CursorKeysMode String Terminal cursor keys mode. Possible values : normal, application 24.5 #!CursorKeysMode application
#!FixedSize String Fixed terminal size (cols x rows) 21.4 #!FixedSize 80x25
#!FontSize Integer Font size in pixels 21.1 #!FontSize 14
#!ForegroundColor String Terminal foreground color. Any CSS value. 22.4 #!ForegroundColor grey
#!KeyboardAccessoryViewLayout String Keyboard accessory view layout. See Keyboard Accessory View Customisation 23.0 #!KeyboardAccessoryView {ESC}{TAB}{CTL}{FN}[/][*]{ARROWS}[|][:][-][!]{PJUMP}{INS}{PGUP}{PGDN}{HOME}{END}[$][.]
#!KeyboardAccessoryViewLayoutIdiomPad String Same as above (overwrites) but only apply to iPad devices 23.0 See above
#!KeyboardAccessoryViewLayoutIdiomPhone String Same as above (overwrites) but only apply to iPhone devices 23.0 See above
#!SFTPTextEditorDefaultFileExtensions String Default file extensions for SFTP text editor. It will allow you to bypass the "Are you sure to edit?" dialog. Comma-separated values. 23.0 #!SFTPTextEditorDefaultFileExtensions .txt,.json,.md
#!RemoteCharacterSet String Remote character set to use. Only applicable to telnet connections. Possible values : UTF-8, CP437 26.2 #!RemoteCharacterSet CP437
#!TermType String $TERM environment variable value 21.4 #!TermType xterm-256color

  1. Based on OpenBSD ssh_config Man ↩

Last update: June 17, 2025