remmina - Man Page

Remmina the GTK+ Remote Desktop Client


remmina [-a|i|n|q|v] [-c FILE] [-e FILE] [-p TABINDEX] [-s SERVER]  [-t PROTOCOL] [-x PLUGIN] [--update-profile]  [--set-option OPTION[=VALUE]] [--display DISPLAY]


Remmina is a remote desktop client written in GTK+, aiming to be useful for system administrators and travellers, who need to work with lots of remote computers in front of either large monitors or tiny netbooks. Remmina supports multiple network protocols in an integrated and consistent user interface.

Currently RDP, VNC, SSH, SPICE, and WWW are supported.

Remmina is released in separated source packages:

Remmina is free and open-source software, released under GNU GPL license.


${XDG_CONFIG_DIRS}/remmina.pref or ${XDG_CONFIG_HOME}/remmina/remmina.pref :

Remmina configuration files.

At the first Remmina execution the system wide Remmina configuration files, will be copied in the ${XDG_CONFIG_HOME}

${XDG_DATA_DIRS}/FILE.remmina or ${XDG_DATA_HOME}/remmina/FILE.remmina :

Remmina profiles, the file name is autogenerated, but you can create manually your own files with the FILE name you prefer. It's possible to specify a custom profile name and location.


-h,  --help

Show help options


Show about dialog

-c,  --connect=FILE

Connect directly either to a desktop using options described in a file, or a supported URI (RDP, VNC, SSH or SPICE).
The filetype can be ".remmina" or one supported by a plugin capable of importing files

-e,  --edit=FILE

Open and edit desktop connection using options described by file, file type can be either .remmina or one supported by a file import capable plugin

-k,  --kiosk

Start Remmina in kiosk mode (thin client)

-n,  --new

Create a new connection profile

-p,  --pref=TABINDEX

Show preferences dialog page

-x,  --plugin=PLUGIN

Execute the plugin

-q,  --quit

Quit the application

-s,  --server=SERVER

Use default server name (for --new)

-t,  --protocol=PROTOCOL

Use default protocol (for --new)

-i,  --icon

Start as tray icon

-v,  --version

Show the application's version


Modify connection profile, require also --set-option

--set-option OPTION[=VALUE]

Set one or more profile settings, to be used with --update-pro-file


Encrypt a password


X display to use


Disable toolbar


Enable fullscreen


Enable extra hardening (disable closing confirmation, disable unsafe shortcut keys, hide tabs, hide search bar)
List of disabled shortcut keys:
fullscreen, autofit, prevtab and nexttab, scale, grab, minimize, viewonly, screenshot, disconnect, toolbar


Disable tray icon


To connect using an exisitng connection profile use: remmina -c FILE.remmina

To quick connect using a URI:

remmina -c rdp://username@server
remmina -c rdp://domain\\username@server
remmina -c vnc://username@server
remmina -c vnc://server?VncUsername=username
remmina -c ssh://user@server
remmina -c spice://server

To quick connect using a URI along with an encrypted password:

remmina -c rdp://username:encrypted-password@server
remmina -c vnc://username:encrypted-password@server
remmina -c vnc://server?VncUsername=username\&VncPassword=encrypted-password

To encrypt a password for use with a URI:

remmina --encrypt-password

To update username and password and set a different resolution mode of a remmina connection profile use:

echo "ausernamenapassword" | remmina --update-profile /PATH/TO/FOO.remmina --set-option username --set-option resolution_mode=2 --set-option password

See Also



Antenore Gatta <antenore at simbiosi dot org> and Giovanni Panozzo <giovanni at panozzo dot it>

See the THANKS file for a more detailed list.

Remmina was initially written by Vic Lee <>

This manual page was written by Antenore Gatta <antenore at simbiosi dot org>.

Referenced By

gnome-session-remmina(1), remmina-file-wrapper(1), remmina-gnome(1).