Jump to content

Remmina

From ArchWiki

Remmina is a remote desktop client written in GTK hosted on Gitlab [1]. It supports the following protocols: SSH, VNC, RDP, X2Go, HTTP(S)

Installation

Install the remmina package.

  • For SPICE support install the spice-gtk package.
  • For RDP support, also install the optional freerdp.
Note If one of the protocols (e.g. RDP) is not available in the Remmina dropdown menu after installing the required package, make sure to completely quit Remmina first: run killall remmina. When you restart Remmina, the protocol should be available.

Configuration

Remmina stores settings and connection profiles under $XDG_CONFIG_HOME/remmina.

File Purpose
remmina.pref Application preferences
*.remmina Connection profiles

System-wide defaults from /etc/xdg/remmina are copied to the user’s configuration directory on first run.

Usage

Remmina connection profiles are saved connection to connect to your servers, the file name is autogenerated, but you can create manually your own files with the FILE name you prefer.

Profiles can be created through the GUI or manually by placing a .remmina file in $XDG_CONFIG_HOME/remmina.

To connect with a saved profile:

$ remmina -c /path/to/example.remmina

Quick connect with URIs

Remmina supports URI-based quick connections:

  • RDP: remmina -c rdp://user@example.com
  • RDP with domain: remmina -c rdp://DOMAIN\\user@example.com
  • VNC: remmina -c vnc://user@example.com
  • VNC with query string: remmina -c vnc://example.com?VncUsername=user
  • SSH: remmina -c ssh://user@example.com
  • SPICE: remmina -c spice://example.com

Using encrypted passwords

URIs can embed encrypted passwords:

  • rdp://user:ENCRYPTED@server
  • vnc://user:ENCRYPTED@server

Generate an encrypted password with:

$ remmina --encrypt-password


Updating profiles from the command line

Profile options can be updated non-interactively. Example:

$ echo "mypassword" | remmina --update-profile ~/.config/remmina/example.remmina \
  --set-option username=user \
  --set-option resolution_mode=2 \
  --set-option password


Tips and tricks

  • Command-line usage is documented at remmina --help.
  • For advanced configuration, see the upstream Remmina wiki.

See also