Troubleshooting Guide

You'll find some troubleshooting tips and information here. If you didn't find the information you are looking for, please write to us at [email protected].

Default Working Directory:

BastionXP creates and stores all its data and files under the default working directory located at: /var/lib/bastionxp. You'll find the log file, server certificates, keys, web app and db files required by the bastionxp app for its operations.

Configuration File:

By default, BastionXP will look for a configuration file named config.json under the /etc/bastionxp/ directory. This config file is not created by default when the software is installed. It is the responsibility of the admin to create this config file after installing the software.

You should always restart the bastionxp service running in the background, whenever you make any changes to the config.json file. This is required for the configuration changes to take effect.

Log File:

BastionXP log file is located in the working directory at: /var/lib/bastionxp/bastionxp.log.

Sometimes, the log file may be of the name bastionxp-auth.log or bastionxp-host.log or bastionxp-proxy.log, depending on whether you run the BastionXP server in auth, host, or proxy mode, respectively.

Always look at the log file for any errors or debugs to find out if there is any problem in the functioning of the server or its configuration.