path: root/Home.md

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 ###
https://launchpad.net/~remmina-ppa-team/+archive/ubuntu/remmina-next

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-get update
sudo apt-get 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`

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.

The [Debian Backports](https://backports.debian.org/Instructions/) repository must be enabled to install it, see [this blog post](https://www.remmina.org/wp/debian-the-boys-are-backport-in-town/) for more information.

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 libfreerdp-plugins-standard
```

### Raspberry Pi

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-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.


### For users with a distro that supports [Flatpak](https://flathub.org/), including Ubuntu ###

```sh
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
```

Just be aware that flatpak store data for installed applications (the XDG config/data folders) under ```$HOME/.var```
So for instance, if you previously have 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```

### For users with a distro that supports [Snap packages](https://snapcraft.io/), including Ubuntu ###

_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](https://github.com/FreeRDP/Remmina/issues/1414)._

Ensure you've `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:

```sh
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:
```sh
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 `edge` channel:

```sh
sudo snap install remmina  --edge
```

Or update the current installed version with the selected channel:

```sh
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

[Hubbitus](https://github.com/Hubbitus) (Pavel Alexeev) provided us a copr, to install just execute as root:

```sh
# dnf copr enable hubbitus/remmina-next
# dnf upgrade --refresh 'remmina*' 'freerdp*'
```
### Sabayon (Gentoo Binary based) 
* Install : 
```
equo- i net-misc/remmina
 ```

### Gentoo 
* 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

Install [remmina-git](https://aur.archlinux.org/packages/remmina-git) from [AUR](https://aur.archlinux.org/)

There are also some external, not supported plugins provided by [Muflone](https://github.com/muflone) :

* [remmina-plugin-exec](https://aur.archlinux.org/packages/remmina-plugin-exec/) A protocol plugin for Remmina to execute an external process.
* [remmina-plugin-folder](https://aur.archlinux.org/packages/remmina-plugin-folder/) A protocol plugin for Remmina to open a folder.
* [remmina-plugin-open](https://aur.archlinux.org/packages/remmina-plugin-open/) A protocol plugin for Remmina to open a document with its associated application.
* [remmina-plugin-rdesktop](https://aur.archlinux.org/packages/remmina-plugin-rdesktop/) A protocol plugin for Remmina to open a RDP connection with rdesktop.
* [remmina-plugin-teamviewer](https://aur.archlinux.org/packages/remmina-plugin-teamviewer/) A protocol plugin for Remmina to launch a TeamViewer connection.
* [remmina-plugin-ultravnc](https://aur.archlinux.org/packages/remmina-plugin-ultravnc/) A protocol plugin for Remmina to connect via VNC using UltraVNC viewer.
* [remmina-plugin-url](https://aur.archlinux.org/packages/remmina-plugin-url/) A protocol plugin for Remmina to open an URL in an external browser.
* [remmina-plugin-webkit](https://aur.archlinux.org/packages/remmina-plugin-webkit/) A protocol plugin for Remmina to launch a GTK+ Webkit browser.

### Solus

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 ##
### CURRENT STATUS ###

Here, on github, we have three official branches:

"next" branch: the future 1.2.0 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 next branch.

"master" 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 "next" branch on [Ubuntu 14.04](Compile-on-Ubuntu-14.04) and [Ubuntu 16.04](Compile-on-Ubuntu-16.04).
* How to compile "next" branch on [Fedora 20](Compile-on-Fedora-20).

### REMMINA GENERATED DOCUMENTATION

[Remmina Development Doc](https://daguniverse.github.io/RemminaDoc/)

## Links ##
We also have a website: http://www.remmina.org