Version: current

Setup your environment

Mac and Linux users

Docker

You can download Docker for Linux and Mac OS here. Please note that you will have to create a free DockerHub account before you can download Docker.

Windows users

We currently support Windows 10 64-bit: Pro, Enterprise, or Education (Build 15063 or later).

Powershell

In order to succesfully execute all commands in this guide make sure you are using PowerShell in administrator mode and not the Command prompt. To launch PowerShell in administrator mode, type PowerShell in the searchfield of the taskbar, you should find Windows PowerShell, right click on it and select Run as Administrator.

Docker

You can download Docker for Windows here. Please note that you will have to create a free DockerHub account before you can download Docker. Docker requires hyper-V to be enabled and Docker will ask you to enable it on start-up if this does not happen you can enable it yourself by running following command in PowerShell.

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Docker-compose (required for NLX Management only)

For setting up the testing environment locally we'll use docker-compose. You can install docker-compose by following the installation steps on the docker website.

OpenSSL

You will need OpenSSL to create the TLS certificates you will need to run NLX. We advise you to install Chocolatey, a package manager for Windows which will install OpenSSL for you.

Once you installed Chocolatey you can install OpenSSL by running

choco install openssl.light

Now close and reopen PowerShell and verify your OpenSSL installation by running

openssl version

if the installation was succesful OpenSSL should print its version number.

Working directory

You can use any directory you want. Just make sure to update the example commands of all future commands accordingly.

First, let's navigate to our home directory.

cd ~

Now, let's create the nlx-setup directory.

mkdir nlx-setup
cd nlx-setup

You can verify your current location by running

pwd

The output should be:

  • For Mac & Windows: /Users/<your-username>/nlx-setup
  • For Linux: /home/<your-username>/nlx-setup

All commands later in this guide assume you are located in this directory.

Edit this page