Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
We are on gitlab
From the 20th of June 2018 the following links have to be used instead og GitHub.
Welcome to the Remmina wiki!
FOR END USERS
Usually Remmina is included in your GNU/Linux distribution or in an external repository. Do not ask for distribution packages or precompiled binaries here. This is a development site.
For Ubuntu users we have an official PPA with Remmina 1.2
To install it, just copy and paste the following three lines on a terminal window
sudo apt-add-repository ppa:remmina-ppa-team/remmina-next sudo apt update sudo apt install remmina remmina-plugin-rdp remmina-plugin-secret
Don't forget to exit/kill al your running instances of remmina. The best way to do it is to reboot your PC. Or, if you cannot reboot, kill all running remmina with
sudo killall remmina
By default the RDP, SSH and SFTP plugins are installed. You can view a list of available plugins with
apt-cache search remmina-plugin
If you are willing to test the development version, you must use an another ppa.
The remmina-next PPA can be used for Raspberry Pi 2 and 3, provided that you are running one of the supported *ubuntu derivatives on your Raspberry Pi.
For Debian 9 (Stretch) users, Remmina is available from the Backports repository
Remmina is not available on the default Debian repositories.
To install Remmina from Debian Backports, just copy and paste the following lines on a terminal window:
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
We have our Remmina package repository for Raspbian Pixel 9.X (stretch), tested on RPi 3B and 3B+, use the following commands to add our repository to your Raspbian:
sudo apt install dirmngr sudo apt-key adv --fetch-keys http://www.remmina.org/raspbian/remmina_raspbian.asc sudo bash -c 'echo "deb http://www.remmina.org/raspbian/ stretch main" > /etc/apt/sources.list.d/remmina_raspbian.list'
Then you can install remmina
sudo apt update sudo apt install remmina
It's also strongly advised to install gnome-keyring to make Remmina save encrypted passwords in a safer place than .remmina text files.
sudo apt install gnome-keyring
On the Raspberry Pi you can also use an Ubuntu derivative, for example Ubuntu Mate, and install Remmina using our ubuntu's PPA remmina-next as explained in this page.
Flatpak, including UbuntuFor users with a distro that supports
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo 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 )
flatpak run --filesystem=$SSH_AUTH_SOCK --env=SSH_AUTH_SOCK=$SSH_AUTH_SOCK org.remmina.Remmina
Just be aware that flatpak store data for installed applications (the XDG config/data folders) under
So for instance, if you previously have installed remmina with another package manager, you will have to transfer what was under
$HOME/.local/share/remmina under, respectively
Snap packages, including UbuntuFor users with a distro that supports
We are still working to deliver a stable Snap package, but we still have many issues with SNAP packaging. If you encounter any issues, try first an other mean of installation and only after report the problem through https://github.com/FreeRDP/Remmina/issues. Snap currently lacks some functionalities, read this chapter to find more informations. Please also note note that currently the SNAP package does not work under Ubuntu 17.10 + Wayland, see issue #1414.
snapd installed in your system. Then in Ubuntu you can install the last release from the Software center, looking for
remmina, otherwise you can install it from terminal with:
sudo snap install remmina
Please note that this is not enough to make remmina fully functional, due to some limitations of the snap subsystem.
Some features, for example password saving via a keyring, are disabled and must be manually enabled:
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, for example accessing your personal ~/.ssh directory is not possible for a snap. You have to manually copy your ~/.ssh/* files under ~/snap/remmina/common/.ssh/
If you want to install latest git revision of remmina, you can use it from the
sudo snap install remmina --edge
Or update the current installed version with the selected channel:
sudo snap refresh remmina --channel=edge # use --channel=stable otherwise
Snap packages will be updated automatically and will include both latest
FreeRDP git and latest
libssh 0.7 release (for better security).
Fedora and Red Hat
As of March 2018 Remmina is available on most fedora testing and stable, we still have a (not updated) copr provided by Hubbitus (Pavel Alexeev), to install just execute as root:
dnf copr enable hubbitus/remmina-next dnf upgrade --refresh 'remmina*' 'freerdp*'
On Red Hat you can enable the EPEL repository:
Note: Unlucky Remmina is not yet in EPEL, you can help submitting a request on the Red Hat bugzilla.
wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm rpm -ivh epel-release-latest-7.noarch.rpm
Sabayon (Gentoo Binary based)
- Install :
equo- i net-misc/remmina
To build and install
emerge -av net-misc/remmina
To build a binary and install
emerge -avb net-misc/remmina
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 # if you have a Bin-host/Binary package server defined on your lan
- (version???) on other machines as a binary if you have many Gentoo machines... directly from file else bin host
Arch Linux based
There are also some external, not supported plugins provided by Muflone :
- remmina-plugin-exec A protocol plugin for Remmina to execute an external process.
- remmina-plugin-folder A protocol plugin for Remmina to open a folder.
- remmina-plugin-open A protocol plugin for Remmina to open a document with its associated application.
- remmina-plugin-rdesktop A protocol plugin for Remmina to open a RDP connection with rdesktop.
- remmina-plugin-teamviewer A protocol plugin for Remmina to launch a TeamViewer connection.
- remmina-plugin-ultravnc A protocol plugin for Remmina to connect via VNC using UltraVNC viewer.
- remmina-plugin-url A protocol plugin for Remmina to open an URL in an external browser.
- remmina-plugin-webkit A protocol plugin for Remmina to launch a GTK+ Webkit browser.
Simply install the newest version of Remmina from the repository with the following command:
sudo eopkg update-repo sudo eopkg install remmina
FOR DEVELOPERS, PACKAGERS AND TESTERS
Here, on github, we have three official branches:
"master" branch: the future 1.2.X version, which compiles with current freerdp master branch and will compile with freerdp 2.0 when released. We will do code developments and bugfixes here, on the master branch.
"oldmaster" branch: the 1.1.2 stable version, which compiles with freerdp 1.1 stable. We will only provide security fixes or critical bugs (i.e.: data corruption) fixes on version 1.1.X.
"gtk2" branch: a special remmina 1.1.1 version compatible with GTK2, compiles with freerdp 1.1 stable
REMMINA BUILDING GUIDES
- How to compile "master" branch on Ubuntu 14.04 and Ubuntu 16.04.
- How to compile "master" branch on Fedora 20.
REMMINA GENERATED DOCUMENTATION
We also have a website: http://www.remmina.org