Scroll to navigation

REMMINA(1) General Commands Manual REMMINA(1)


remminaRemmina 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, NX, XDMCP, and WWW are supported.

Remmina is released in separated source packages:

"remmina", the main GTK+ application
"remmina-plugins", a set of plugins

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.


Show help options
Show about dialog
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
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
Start Remmina in kiosk mode (thin client)
Create a new connection profile
Show preferences dialog page
Execute the plugin
Quit the application
Use default server name (for --new)
Use default protocol (for --new)
Start as tray icon
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-profile
Encrypt a password
X display to use


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 "ausername\napassword" | remmina --update-profile /PATH/TO/FOO.remmina --set-option username --set-option resolution_mode=2 --set-option password




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>.


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.