Jump to content

# Remmina

From ArchWiki

Related articles

- Rdesktop
- xrdp

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 VNC support install the libvncserver or the gtk-vnc package.

- For SPICE support install the spice-gtk package.

- For RDP support, also install the optional freerdp.

- Password saving depends on GNOME Keyring or KDE Wallet.

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

- Remmina GitLab Repository
- https://gitlab.com/Remmina/Remmina/-/wikis/Home

Category:

- Remote desktop

Remmina
Add topic