Funbit / mRemoteNG

mRemoteNG is the next generation of mRemote, open source, tabbed, multi-protocol, remote connections manager.

An open source, multi-protocol, tabbed remote connections manager allowing you to view all of your connections in a simple yet powerful interface

---

Update Channel	Build Status	Downloads
Stable
Prerelease

Features

The following protocols are supported:

• RDP (Remote Desktop Protocol)
• VNC (Virtual Network Computing)
• SSH (Secure Shell)
• Telnet (TELecommunication NETwork)
• HTTP/HTTPS (Hypertext Transfer Protocol)
• rlogin (Remote Login)
• Raw Socket Connections
• Powershell remoting

For a detailed feature list and general usage support, refer to the Documentation.

Installation

Supported Operating Systems

• Windows 10
• Windows 8.1
• Windows Server 2019
• Windows Server 2016
• Windows Server 2012 R2

Packaging

Downloads are provided in three different packages.

Binary package

The binary package of mRemoteNG is a compiled version of mRemoteNG which comes in an MSI installer. This is the most common way to install mRemoteNG and get up and running.

Portable package

The portable package contains a modified version of the executable which stores and loads all your settings from files in the application's directory. This package can be used to run mRemoteNG from a USB stick and preserve your configuration wherever you go.

Source package

This contains the source code from which mRemoteNG is build. You will need to compile it yourself using Visual Studio.

Minimum Requirements

• Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019
• Microsoft .NET Framework 4.0
• Microsoft Terminal Service Client 6.0 or later
  • Needed if you use RDP. mstscax.dll and/or msrdp.ocx be registered.
• Citrix ICA Client
  • Needed if you use ICA. wfica.ocx must be registered

Download

mRemoteNG is available as a redistributable MSI package or as a portable ZIP package and can be downloaded from the following locations:

• GitHub
• Project Website

Command line install

The MSI package of mRemoteNG can be installed using the command line:

msiexec /i C:\Path\To\mRemoteNG-Installer.exe [INSTALLDIR=value] [IGNOREPREREQUISITES=value]

Property	Value	Description
INSTALLDIR	folder path	This allows you to set the installation directory from the command line. For paths that contain spaces, enclose the path in double quotes (""). This overrides any value found in the registry.
IGNOREPREREQUISITES	0 or 1	When set to 1, the installer will not be halted if any prerequisite check is not met. You must still run the installer as administrator.

Examples

Install to a custom folder

msiexec /i C:\Path\To\mRemoteNG-Installer.msi INSTALLDIR="D:\Work Apps\mRemoteNG"

Ignore prerequisites during a normal install

msiexec /i C:\Path\To\mRemoteNG-Installer.msi IGNOREPREREQUISITES=1

Ignore prerequisites during a silent install

msiexec /i C:\Path\To\mRemoteNG-Installer.msi /qn IGNOREPREREQUISITES=1

Troubleshooting installation

Turn on verbose logging by using the /lv* <log path> argument at the command line.

msiexec /i C:\Path\To\mRemoteNG-Installer.msi /l*v C:\mremoteng_install.log

Uninstall

Standard Uninstall

mRemoteNG basic binary package can be uninstalled with Windows Control Panel. If for some reason it does not work please follow information provided below for Manual Uninstall.

Manual Uninstall

If you are using the Portable version, simply deleting the folder that contains mRemoteNG should be sufficient. These uninstall instructions are only necessary for the normal binary .MSI installed version of mRemoteNG

• Delete the folder where mRemoteNG was installed. By default, this is: %PROGRAMFILES%\mRemoteNG

• Delete the mRemoteNG install entry from one of the following locations. Search for "mRemoteNG" in the DisplayName field:

  • x86: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\
  • x64: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\

• (Optional) If you would also like to delete user data remove %LOCALAPPDATA%\mRemoteNG

Featured Projects

• PSmRemoteNG A module to create mRemoteNG connection files from PowerShell.

Contribute

If you find mRemoteNG useful and would like to contribute, it would be greatly appreciated. When you contribute, you make it possible for the team to cover the costs of producing mRemoteNG.

Submit Code

Check out the Wiki page on how to configure your development environment and submit a pull request.

Translate

Check out the Wiki page on how to help make mRemoteNG a polyglot.