How to Configure Central Server?

Owned by Petteri Kivimäki
Last updated: Jul 06, 2023


This article is for X-Road versions < 7.3.0. Instructions for X-Road versions >= 7.3.0 are available here.

Table of contents

1. Configuration of the Central Server

1.1 Logging in to the administration interface and creating initial configuration

The official Central Server installation guide is available at: https://github.com/nordic-institute/X-Road/blob/develop/doc/Manuals/ig-cs_x-road_6_central_server_installation_guide.md

After installing the Central Server the admin interface can be found at https://<CENTRAL_SERVER_URL>:4000. At the first time the self-signed certificate from the server needs to be accepted.

If you go to the URL right after the installation has finished, usually the background services have not started yet and an error message 502 Bad Gateway is returned.

Wait for a while and eventually the browser connects to the admin interface. 

  • Enter the admin interface root user credentials created during the installation phase.
  • Press LOGIN.

In the initial configuration screen you need to input the following information.

  • X-Road instance name.
  • Server FQDN.
  • PIN-code that protects the server's secret keys.
  • Press SUBMIT

The initial configuration is saved and the server outputs message Central Server Initialized.