path: root/Home.md

## *Welcome to the Remmina wiki*

Remmina is developed on [GitLab](https://gitlab.com/Remmina/Remmina), as of the 20th of June 2018.

Use these [wiki](https://gitlab.com/Remmina/Remmina/wikis/home) and [issues](https://gitlab.com/Remmina/Remmina/issues) links instead of GitHub equivalents.

---
Usually Remmina is [included in your distribution](https://repology.org/project/remmina/versions), or in an external repository you can add.

[![Packaging status](https://repology.org/badge/vertical-allrepos/remmina.svg?columns=4&minversion=1.3?allow_ignored=1)](https://repology.org/project/remmina/versions)

## [Ubuntu](https://ubuntu.com/) and [Linux Mint](https://linuxmint.com/)

The latest Remmina release can be installed from an official PPA by copying and pasting this in a terminal:
```
sudo apt-add-repository ppa:remmina-ppa-team/remmina-next
sudo apt update
sudo apt install remmina remmina-plugin-rdp remmina-plugin-secret
```
Make sure Remmina is not running. Either close it, reboot, or kill it by pasting this in a terminal:
```
sudo killall remmina
```
List available plugins with `apt-cache search remmina-plugin`. By default RDP, SSH and SFTP are installed.
To test a daily built development version, do the above, but start with this instead:
```
ppa:remmina-ppa-team/remmina-next-daily
```

## [Debian](https://www.debian.org/)

### 10 [Buster](https://wiki.debian.org/DebianBuster) (stable), [Bullseye](https://wiki.debian.org/DebianBullseye) (testing), and [Sid](https://wiki.debian.org/DebianUnstable) (unstable)

Remmina is in the official stable, testing and unstable repositories.

### 9 [Stretch](https://wiki.debian.org/DebianStretch) (oldstable)
Here Remmina can be [installed from backports](https://www.remmina.org/debian-the-boys-are-backport-in-town/) by copying and pasting this in a terminal:
```
echo 'deb http://ftp.debian.org/debian stretch-backports main' | sudo tee --append /etc/apt/sources.list.d/stretch-backports.list >> /dev/null
sudo apt update
sudo apt install -t stretch-backports remmina remmina-plugin-rdp remmina-plugin-secret remmina-plugin-spice
```

## [Raspberry Pi](https://www.raspberrypi.org/)

Remmina operates its own package repository for Raspbian Buster (10.x) you can install by copying and pasting this in a terminal:
```
sudo apt install dirmngr
sudo apt-key adv --fetch-keys https://www.remmina.org/raspbian/remmina_raspbian.asc
sudo bash -c 'echo "deb https://www.remmina.org/raspbian/ buster main" > /etc/apt/sources.list.d/remmina_raspbian.list'
sudo apt update
sudo apt install remmina
```
(Tested on RPi 3B and 3B+)
It is strongly advised to also install gnome-keyring to let Remmina save encrypted passwords in a safer place than .remmina textfiles in the /home user folder.
```
sudo apt install gnome-keyring
```

(The remmina-next PPA can be used on Raspberry Pi 2 and 3, provided you are running one of the supported *buntu derivatives.)

## [Flatpak](https://flathub.org/)

This is a system agnostic package that works on just about every distribution.

```shell
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
# In order to have H.264 codecs
flatpak install org.freedesktop.Platform
flatpak install org.freedesktop.Platform.openh264 
flatpak install --user flathub org.remmina.Remmina
flatpak run --user org.remmina.Remmina
```

If you use SSH agent (https://github.com/flatpak/flatpak/issues/1438 )

```shell
flatpak run --filesystem=$SSH_AUTH_SOCK --env=SSH_AUTH_SOCK=$SSH_AUTH_SOCK org.remmina.Remmina
```

Flatpak stores data for installed applications (the XDG config/data folders) under `$HOME/.var`
If you have previously installed Remmina with another package manager, you will have to transfer what was under `$HOME/.config/remmina` and `$HOME/.local/share/remmina` under, respectively `~/.var/app/org.remmina.Remmina/config/remmina` and `~/.var/app/org.remmina.Remmina/data/remmina`

## [Snap](https://snapcraft.io/)

This also is a system agnostic package that works on many distributions, but mainly Ubuntu.

If you run into issues, try something else first, and then [report the issues](https://github.com/FreeRDP/Remmina/issues).
Our Snap package does not work on Ubuntu 17.10 if you use Wayland, see [issue #1414](https://github.com/FreeRDP/Remmina/issues/1414)._

First make sure you have `snapd` installed. Then install the last release from the Ubuntu Software Center by looking for `Remmina`, or install it from a terminal with:

```shell
sudo snap install remmina
```

The Snap subsystem has limitations, so some features, for example password storage via keyring is missing and *must* be fixed manually:

```shell
sudo snap connect remmina:avahi-observe :avahi-observe # servers discovery
sudo snap connect remmina:cups-control :cups-control # printing
sudo snap connect remmina:mount-observe :mount-observe # mount management
sudo snap connect remmina:password-manager-service :password-manager-service # password manager
```
Some features just don't work on Snap, for example accessing your personal ~/.ssh directory is not possible.
You have to manually copy your ~/.ssh/* files to ~/snap/remmina/common/.ssh/

If you want to install latest Git revision of Remmina as Snap, get it from the `edge` channel:

```shell
sudo snap install remmina  --edge
```

**Or**, update your Remmina Snap install with your channel of choice:

```shell
sudo snap refresh remmina --channel=edge # use --channel=stable otherwise
```

Snaps are updated with the system and include both the latest `FreeRDP` Git and the latest `libssh 0.7` release (for better security).

## [Fedora](https://getfedora.org/) and [Red Hat](https://www.redhat.com)

As of March 2018 Remmina is available on most Fedora testing and stable, we still have a (not updated) Copr provided by [Hubbitus](https://github.com/Hubbitus) (Pavel Alexeev), to install, paste this in a terminal as root:

```shell
dnf copr enable hubbitus/remmina-next
dnf upgrade --refresh 'remmina*' 'freerdp*'
```

## [Red Hat](https://www.redhat.com)

Install Remmina from the EPEL repository by pasting this in a terminal:

```shell
wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
rpm -ivh epel-release-latest-7.noarch.rpm
```

## [Gentoo](https://www.gentoo.org/)
* To build and install
```shell
emerge -av net-misc/remmina
```

* To build a binary and install
```shell
emerge -avb net-misc/remmina
```

```shell
emerge -avk remmina*.tar.bz
# From cp /usr/portage/packages/net-misc remmina* > /mnt/some-usb-stick to multiple boxes
emerge -avk =net-misc/remmina-#??Version number
```

## [Sabayon](https://www.sabayon.org/)
```
equo -i net-misc/remmina
 ```

## [Arch Linux](https://www.archlinux.org/) (and friends)

There is an official Arch Linux Remmina package. **Or**, if you want to use the AUR, install [remmina-git](https://aur.archlinux.org/packages/remmina-git).
There are also some external, not supported plugins provided by [Muflone](https://github.com/muflone) and other
Arch Remmina [Protocol plugins](https://aur.archlinux.org/packages/?O=0&SeB=nd&K=Remmina&outdated=&SB=n&SO=a&PP=50&do_Search=Go)

## [Solus](https://getsol.us/home/)

```shell
sudo eopkg update-repo
sudo eopkg install remmina
```

## [Build from source](https://gitlab.com/Remmina/Remmina/-/branches)

* How to compile "master" branch on [Ubuntu 14.04](Compile-on-Ubuntu-14.04), [Ubuntu 16.04](Compile-on-Ubuntu-16.04) and [Fedora 20](Compile-on-Fedora-20).

* Code development and bugfixes take place on the master branch.
 It compiles with the current FreeRDP master branch, and will compile with [FreeDRP](http://www.freerdp.com/) 2.0 when released as stable. 

# Links

- [Remmina website](https://www.remmina.org/)
- [Remmina subreddit](https://reddit.com/r/Remmina)
- [Remmina Development Doc](https://remmina.gitlab.io/remminadoc.gitlab.io)
- [Versions for various operating systems](https://repology.org/project/remmina/versions)