Configuration wizard can be used to initially configure Navixy platform or change some common settings.
All of the settings described below can be applied directly to the database and service configurations, but in this case there is a risk of malfunctioning if handled carelessly. Using the configurator avoids this risk.
If you have a non-standard platform installation, or your task is beyond the capabilities of this wizard, you can use the various configuration guides on this website for specific tasks or contact technical support.
To run the wizard, go to the Navixy package directory and run ./configure.sh
You will be greeted by the main menu:

Below is the explanation of each menu and sub-menu:
The only option here is to change domain names.
The Configuration Wizard allows you to configure only three domain names - separate for API, for admin panel and for the user interface. If you need to perform the configuration using only one domain or with no domain name at all, you need to refer to the instruction for manual platform installation.
If you want to continue configuring three domain names, you will be prompted to enter the base domain first - that is, enter the second and top level domains, e.g. example.com.
After that, you need to sequentially specify domain names for API, admin panel and user interface. Be careful - here you specify only third-level domain names, without specifying the second and top levels.
Once all domains are specified, the wizard will show you the results of your configuration. If you need something to be changed, run the wizard once again
You can learn more information about domain names at this page.
Here you can apply settings of your SMS-gateway, and also specify credentials of service SMS sender.
1. Configure SMS gateway
The first option in this menu allows you to disable the SMS gateway if you already have one set up and no longer need to use it.
The other options allow you to apply settings for a specific SMS gateway service provider.
The last option allows you to connect the SMS gateway via SMPP protocol. This option is also suitable if your gateway provider is not on the list, but it supports SMPP on its side.
You can learn more about SMS gateways on the corresponding page on this website.
2. Configure FROM name and phone number
In this menu you can specify the number and name of the sender of service SMS messages, if necessary.
Here you can configure only feedback email settings.
Please note: Main email gateway settings are configured from the admin panel (more information on email gateway).
The script will ask you to specify the email address to receive user feedbacks from a help section (TO email address).
Then you will be asked about user email substitution.
Select YES to use the email address of the user to send feedback requests.
Select NO to replace the sender's email address with a specific one. In this case, the script will ask you to specify this email address (FROM email address).
Here you can specify the Google maps API key if you did not purchase the Premium GIS package from Navixy, but preferred to use the key you purchased yourself.(More information on API keys)
First, you need to specify Google API JavaScript key (required for maps availability).
Next, apply Google API server key (required for geocoding operations).
This section contains two options.
1. Change license key
Here you can specify the license key for your On-premise instance. The license key is applied during the initial installation of the platform, or if it is lost or corrupted for some reason (usually a consequence of tampering with the database). The license key is issued and provided by technical support.
After selecting this option, you will see a warning that changing the license key carelessly may cause the platform to become inoperable.
After that you need to apply the license key you received. This is a rather long combination of characters, so it can be quite difficult to enter manually. You can paste the key from a clipboard by using Shift+Insert
combination. Alternatively, you can hold Shift
and use mouse right click
.
The key will be inserted into the database, and your instance will have a valid license.
2. Request trial key
This option can only be used to get a one-time trial key. The key is valid for 30 days.
- You cannot re-issue or renew the trial key in this way.
- You cannot restore a lost key in this way.
- You cannot restore a disabled license in this way.
If your trial expired and you need to continue using your On-premise instance, contact technical support.
Plugins allow to modify or enable various functions of the platform. Since the configurator is designed for basic platform configuration, you can only find three plugins in this menu.
1. Activation code settings
Here you can enable or disable the use of mandatory activation codes for device registration. If the "Mandatory" option is enabled, users will not be able to register a device without an activation code.
2. Custom logo settings
Here you can set up a special logo for an individual user.
Please note: the logo for the entire platform is customized in the admin panel.
The configuration wizard will ask you to specify the user ID (it can be found in the admin panel or in the user interface)
Next, you need to specify a link to the user's logo. It can only be located on an external resource, there is no possibility to store it on the server. The recommended size is 400x400 pixels, PNG format.
The logo will be applied to the interface and to the reports.
3. Help section settings
Here you can choose whether to hide or show help section in the user interface (it is shown by default). Help section leads to Navixy website, so its disabling may be useful for white labeling.
This section allows you to enable and disable file storage.
It is used to store file and image attachments to the task forms and maintenance works. The default directory for storing files is /home/java/api-server/files.
This menu allows us to install SSL certificates if your platform is configured to use HTTPS. The only option here is to install SSL certificates.
You will see a warning that you will need a registered DNS record and a public IP address. Confirm to continue.

The script will ask you whether you are going to use free Letsencrypt SSL certificates, or you want to use your own certificates.
LetsEncrypt
Select Yes to install free LetsEncrypt SSL certificates for your domains. This installation also implies certificates auto-prolonging every three months, which is also free

The script will install the software needed to issue the certificate. You will need to accept the terms of service - enter y
.

Next, you will be prompted to select domains for which to install certificates. It is recommended that you do this for all domains at once. To do this, you do not need to specify anything, just leave the field empty and press Enter
.

Your certificate
If you choose "NO" when the script asks you if you want to install a LetsEncrypt certificate, you will be directed to the menu to install your own SSL certificate.
To proceed, you must have a valid full-chain certificate as well as its private key. Place them somewhere on your server. The standard location is /etc/nginx/ssl.
First you need to specify a path to the certificate file:
Next, specify the path to the private key file:
The paths to your certificates will be inserted to Nginx configuration.
Certificates are now installed, and your domains are SSL-protected.