Start NLX using Docker Compose
Now we have prepared all the requirements to run NLX, we can start all components using Docker Compose.
Next to the certificates you created in retrieve a demo certificate you also need certificates from an internal PKI to encrypt traffic between NLX components (such as the Management API and the Inway). The script already automatically generated these internal certificates.
Set the hostname of the Inway (where
my-organization.nl:8443 should be replaced with your own hostname).
- Mac & Linux
$env:INWAY_SELF_ADDRESS = 'my-organization.nl:443'
$env:MANAGEMENT_API_PROXY_ADDRESS = 'my-organization.nl:8443'
Start all components by running:
docker-compose up -d
This will start PostgreSQL and the required NLX components.
The NLX components are configured using environment variables which in this guide are set in
Let's create a user, so we can access NLX Management:
docker-compose exec api nlx-management-api create-user --email firstname.lastname@example.org --password=development --role admin
The username is
email@example.com and the password is
development. Feel free to use the credentials you prefer.
At last, let's verify if all the components are up and running:
It might take a while for all components to become healthy. If after a while one or more components are not running, you can inspect the logs for any errors.
Access the Management UI
You can access the Management UI by opening
http://localhost:8080 in your browser.
When you do you should see the login screen:
You can login with the demo credentials:
- Username: firstname.lastname@example.org
- Password: development
Accepting the Terms of Service (ToS)
You will have to accept the Terms of Service before you can make use of the NLX network. You can do so by logging in to NLX Management. Please review the terms carefully before accepting them.
Management UI overview
On the left you will find the main navigation which separates the UI in several pages:
- Inways: Lists all available inways.
- Services: Shows a list of your services. You can also register new services here.
- Directory: Lists all available services in the demo directory. This is also the place where you can request access to another service.
- Settings: Shows all global settings.
- Finance: Download financial information about the usage of your services.
- Logs: Lists the audit logs for your NLX installation.
Set the organization inway
In order to receive Access Requests and send/receive Orders, you have to set a default inway for your organization. You can do that by going to the settings page, selecting the "Inway-01" and clicking on "Save settings".
In the Docker Compose file we have started, access requests can be accepted by the inway on port
8444. Make sure that port is publicly accessible.
The transaction log is also included with this setup. For every request made through your outway or inway, a record is created in the transaction log. To view the content of the transaction log run the following command:
docker-compose exec postgres psql -U postgres -d nlx_txlog -c "select * from transactionlog.records;"
So far we have:
- Started all components using Docker Compose
- Logged in to the Management UI
- Set a default organization inway