Customer ID



NoMachine Support

Your questions answered

Tips on how to set up your Raspberry Pi for remote access via NoMachine

NoMachine can be installed on most flavours of Linux, and that also includes Linux ARM. Those familiar with Linux ARM are probably well read on the different number of tiny sized computers available on the market such as Banana Pi, Beaglebone, Radxa Rock and CuBox TV. These little computers fit in the palm of your hand, yet pack enough power to run as a desktop PC. They can also be used as thin clients, NAS storage devices, a file server and even as a home media server which you might want to access from another room. They are therefore perfect for NoMachine.

One of the more popular devices that our users have shown interest in is the Raspberry Pi, so we've put together some top tips to get your Raspberry Pi set up for remote control via NoMachine on your home network or over an internet connection. This is really useful if you want to run your Pi as a 'headless' machine without the need for its own monitor, mouse and keyboard - instead you can use your home computer, iPad or Android tablet to access and control your Pi. Or if you want, access it from another Pi! All you need is NoMachine installed on all of the devices you want to use.

Setting up the Raspberry Pi

First, you will need to set up your device, so that you can then install NoMachine on it. Although there are a number of Linux-based Pi distributions available, we will be using the latest version of Raspbian: the official OS for Raspberry Pi. The easiest way to do this is by downloading the New Out Of the Box System (NOOBS) installer:

They also provide a very simple guide to setting up your device with a monitor and keyboard; handy if you are using your device as client from which to connect to another NoMachine-enabled remote computer:

Enable Raspberry Pi boot to Desktop

Raspbian has a graphical interface (GUI) similar to that of Windows or Mac OS X. You can do most of your day-to-day tasks in this interface. Once you've got Rasbian installed, to make sure you get the graphical desktop every time you start up your Raspberry, you'll need to set what happens when your Pi boots. When you first boot in to Raspbian you will be shown the Raspberry Pi configuration tool 'raspi-config. To open the configuration tool after this, simply run 'sudo raspi-config' from the command line using a shell or terminal window (on Raspbian it's called LXTerminal).

Let's change the boot preference to Desktop:

  • Enter raspi-config.
    sudo raspi-config
  • Enter option 3 - "Enable Boot to Desktop/Scratch".
  • Enter option 2 - "Desktop Log in as user 'pi' at the graphical desktop".
  • Enter your password if prompted.
  • Choose "Finish".
  • Choose "Yes" to reboot.

So, now you've set up the Raspbian desktop, let's get NoMachine installed.

Downloading and Installing NoMachine

Once you've got your Raspberry Pi plugged in and you're logged on to its desktop, you will need to download the NoMachine package for ARMv6 which is Raspbian compatible (please consult the following article for more information about compatible packages for Pi models). Open up the browser and go to the NoMachine website to download:

We'll install NoMachine via the command line using LXTerminal.

Open the location of where you have downloaded the NoMachine package. By default it's the Downloads folder in the user's home directory (Fig. 1). Then proceed with installing:

$ sudo dpkg -i nomachine_4.6.12_1_armv6hf.deb
Installing NoMachine from the command line on Raspberry Pi

Fig. 1 - Installing NoMachine from the command line

Complete installation (how to update and uninstall) instructions for Linux packages are available at .

Let's start using NoMachine.

Using NoMachine on your Raspberry

As we hinted at earlier, you can use your Raspberry Pi as either a connecting device or as a computer that you want to remotely access.

Connecting from your Raspberry thin client to another computer

Now that you've installed NoMachine, you're almost ready. On Raspbian, NoMachine is installed under Internet. Click on the Raspberry icon menu and navigate to select NoMachine (Fig. 2). The NoMachine User Interface will open.

If you've already used NoMachine, you will know that you'll need the IP address of the computer you want to connect to, and you must have previously installed NoMachine there, too.

If you are new to NoMachine, you should check out our illustrated tutorial to get started on your first connection. Once you have the IP address of the remote PC or Mac you want to access, you're ready to start using NoMachine on your Raspberry thin client to connect to it.

Use NoMachine on Raspberry Pi as a thin client to remotely control another computer

Fig. 2 - NoMachine on Raspberry Pi as a thin client to remotely control another computer

Remotely connecting to your Raspberry from another device

If you are using Raspberry Pi as a server, the sky's your limit to how you use it. By installing the free NoMachine package for Linux ARM, you can remotely control it from wherever you are, work on documents, transfer files back and forth, view videos and games running on it, and much more. You can connect from any Linux, Windows or Mac computer and clients are available for iPad and Android tablets. Select the NoMachine package for your OS from our download section of the website:

Use your Raspberry Pi as a server and remotely connect to its Raspbian desktop using NoMachine

Fig. 3 - Connecting to the Raspbian desktop on Raspberry Pi with NoMachine

Additional tips to get the most out of your Raspberry Pi

The Raspberry Pi is a device that requires additional configuration depending on how you want to use it. The following tips can help you to configure your device, ready to install NoMachine.

Tip 1: Tweaking the resolution on Raspberry

Raspbian automatically sets the resolution and it can be a little smaller than the screen that you are viewing from. To set resolution on Raspberry Pi:

  • Edit file config.txt located in /boot directory
      sudo vim /boot/config.txt
  • Locate and uncomment (remove the hash in front of the line) the following lines and enter the desired value. E.g.

    For a list of all supported modes and groups refer to the Raspberry website. Since our monitor was wide screen with full HD we selected 31. You should choose what the native resolution of your monitor is.

  • Save and exit
  • Reboot
    sudo reboot

Tip 2: Connecting to a headless Raspberry

If you are using your Raspberry Pi as a headless box (you might not want a monitor and keyboard attached to it), the system defaults to low resolution. You will therefore need to force HDMI output mode even if no HDMI monitor is detected.

  • Edit file config.txt located in /boot directory
      sudo vim /boot/config.txt
  • Locate and uncomment (remove hash in front of the line) following line
  • Save and exit
  • Reboot
    sudo reboot
Set up Raspberry as a headless box and access it using NoMachine

Fig. 4 - Setting up Raspberry as a headless box

Tip 3: Optimizing memory usage

Raspberry Pi has 1 GB of RAM and you can tell it to split the RAM between running programs (system) and how much is to be used by the GPU. The amount of RAM required depends on your needs. Default 64MB to the GPU should suit most tasks however it may require more for decoding 1080p HD videos. We recommend you set it at 128. This will improve overall performance of the device when running a NoMachine remote desktop session.

  • Enter raspi-config
    sudo raspi-config
  • Enter option 8 - "Advanced Options"
  • Enter option 2 - "Memory Split"
  • Enter desired value (128)
  • Choose "Finish"
  • Choose "Yes" to reboot

We'd love to know how you are using your Raspberry Pi with NoMachine!