1 ## *Welcome to the Remmina wiki*
3 Remmina is developed on [GitLab](https://gitlab.com/Remmina/Remmina), as of the 20th of June 2018.
5 Use these [wiki](https://gitlab.com/Remmina/Remmina/wikis/home) and [issues](https://gitlab.com/Remmina/Remmina/issues) links instead of GitHub equivalents.
8 Usually Remmina is [included in your distribution](https://repology.org/project/remmina/versions), or in an external repository you can add.
10 [![Packaging status](https://repology.org/badge/vertical-allrepos/remmina.svg?columns=4&minversion=1.3?allow_ignored=1)](https://repology.org/project/remmina/versions)
12 ## [Ubuntu](https://ubuntu.com/) and [Linux Mint](https://linuxmint.com/)
14 An official PPA with the latest Remmina release can be install by copying and pasting this in a terminal:
17 sudo apt-add-repository ppa:remmina-ppa-team/remmina-next
19 sudo apt install remmina remmina-plugin-rdp remmina-plugin-secret
22 Make sure Remmina is not running. Either close it, reboot, or kill it by pasting this in a terminal:
28 List available plugins with `apt-cache search remmina-plugin`. By default RDP, SSH and SFTP are installed.
29 To test a daily built development version, do the above, but start with
32 ppa:remmina-ppa-team/remmina-next-daily
35 ## [Debian](https://www.debian.org/)
37 ### 10 [Buster](https://wiki.debian.org/DebianBuster) (stable), [Bullseye](https://wiki.debian.org/DebianBullseye) (testing), and [Sid](https://wiki.debian.org/DebianUnstable) (unstable)
39 Remmina is in the official stable, testing and unstable repositories.
41 ### 9 [Stretch](https://wiki.debian.org/DebianStretch) (oldstable)
43 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:
45 echo 'deb http://ftp.debian.org/debian stretch-backports main' | sudo tee --append /etc/apt/sources.list.d/stretch-backports.list >> /dev/null
47 sudo apt install -t stretch-backports remmina remmina-plugin-rdp remmina-plugin-secret remmina-plugin-spice
50 ## [Raspberry Pi](https://www.raspberrypi.org/)
52 Remmina operates its own package repository for Raspbian Buster (10.x) you can install by copying and pasting this in a terminal:
54 sudo apt install dirmngr
55 sudo apt-key adv --fetch-keys https://www.remmina.org/raspbian/remmina_raspbian.asc
56 sudo bash -c 'echo "deb https://www.remmina.org/raspbian/ buster main" > /etc/apt/sources.list.d/remmina_raspbian.list'
58 sudo apt install remmina
60 (Tested on RPi 3B and 3B+)
61 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.
63 sudo apt install gnome-keyring
66 (The remmina-next PPA can be used on Raspberry Pi 2 and 3, provided you are running one of the supported *buntu derivatives.)
68 ## [Flatpak](https://flathub.org/)
70 This is a system agnostic package that works on just about every distribution.
73 flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
74 # In order to have H.264 codecs
75 flatpak install org.freedesktop.Platform
76 flatpak install org.freedesktop.Platform.openh264
77 flatpak install --user flathub org.remmina.Remmina
78 flatpak run --user org.remmina.Remmina
81 If you use SSH agent (https://github.com/flatpak/flatpak/issues/1438 )
84 flatpak run --filesystem=$SSH_AUTH_SOCK --env=SSH_AUTH_SOCK=$SSH_AUTH_SOCK org.remmina.Remmina
87 Flatpak stores data for installed applications (the XDG config/data folders) under `$HOME/.var`
88 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`
90 ## [Snap](https://snapcraft.io/)
92 This also is a system agnostic package that works on many distributions, but mainly Ubuntu.
94 If you run into issues, try something else first, and then [report the issues](https://github.com/FreeRDP/Remmina/issues).
95 Our Snap package does not work on Ubuntu 17.10 if you use Wayland, see [issue #1414](https://github.com/FreeRDP/Remmina/issues/1414)._
97 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:
100 sudo snap install remmina
103 The Snap subsystem has limitations, so some features, for example password storage via keyring is missing and *must* be fixed manually:
106 sudo snap connect remmina:avahi-observe :avahi-observe # servers discovery
107 sudo snap connect remmina:cups-control :cups-control # printing
108 sudo snap connect remmina:mount-observe :mount-observe # mount management
109 sudo snap connect remmina:password-manager-service :password-manager-service # password manager
112 Some features just don't work on Snap, for example accessing your personal ~/.ssh directory is not possible.
113 You have to manually copy your ~/.ssh/* files to ~/snap/remmina/common/.ssh/
115 If you want to install latest Git revision of Remmina as Snap, get it from the `edge` channel:
118 sudo snap install remmina --edge
121 **Or**, update your Remmina Snap install with your channel of choice:
124 sudo snap refresh remmina --channel=edge # use --channel=stable otherwise
127 Snaps are updated with the system and include both latest `FreeRDP` Git and the latest `libssh 0.7` release (for better security).
129 ## [Fedora](https://getfedora.org/) and [Red Hat](https://www.redhat.com)
131 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:
134 dnf copr enable hubbitus/remmina-next
135 dnf upgrade --refresh 'remmina*' 'freerdp*'
138 ## [Red Hat](https://www.redhat.com)
140 Install Remmina from the EPEL repository by pasting this in a terminal:
143 wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
144 rpm -ivh epel-release-latest-7.noarch.rpm
147 ## [Gentoo](https://www.gentoo.org/)
152 emerge -av net-misc/remmina
155 To build a binary and install
158 emerge -avb net-misc/remmina
162 emerge -avk remmina*.tar.bz
163 # From cp /usr/portage/packages/net-misc remmina* > /mnt/some-usb-stick to multiple boxes
164 emerge -avk =net-misc/remmina-#??Version number
167 ## [Sabayon](https://www.sabayon.org/)
170 equo -i net-misc/remmina
173 ## [Arch Linux](https://www.archlinux.org/) (and friends)
175 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).
176 There are also some external, not supported plugins provided by [Muflone](https://github.com/muflone) and other
177 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)
179 ## [Solus](https://getsol.us/home/)
182 sudo eopkg update-repo
183 sudo eopkg install remmina
186 ## [Build from source](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation)
188 - [Compilation guide for CentOS](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compilation-guide-for-CentOS)
189 - [Compile on Arch Linux](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Arch-Linux)
190 - [Compile on Debian 10 Buster](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-10-Buster)
191 - [Compile on Debian 9 Stretch](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Debian-9-Stretch)
192 - [Compile on Fedora 20 ~ 26](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Fedora-20-~-26)
193 - [Compile on FreeBSD](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-FreeBSD)
194 - [Compile on Ubuntu 14.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-14.04)
195 - [Compile on Ubuntu 16.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-16.04)
196 - [Compile on Ubuntu 18.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-18.04)
197 - [Compile on Ubuntu 20.04](https://gitlab.com/Remmina/Remmina/-/wikis/Compilation/Compile-on-Ubuntu-20.04)
199 Code development and bugfixes take place on the master branch.
200 It compiles with the current FreeRDP master branch, and will compile with [FreeDRP](http://www.freerdp.com/) 2.0 when released as stable.
204 - [Remmina website](https://www.remmina.org/)
205 - [Remmina subreddit](https://reddit.com/r/Remmina)
206 - [Remmina Development Doc](https://remmina.gitlab.io/remminadoc.gitlab.io)
207 - [Versions for various operating systems](https://repology.org/project/remmina/versions)