Learn about the Bitnami Configuration Tool

The Bitnami Configuration Tool is a command line tool that allows you to configure your application once it is installed. This tool is located in the application directory at /opt/bitnami/apps/APP-NAME.

To understand how to run this tool, execute the command below:

$ cd /opt/bitnami/apps/APP-NAME
$ ./bnconfig --help

In some cases, the Bitnami Configuration Tool is named bnconfig.disabled. In these cases, use the commands below instead:

$ cd /opt/bitnami/apps/APP-NAME
$ ./bnconfig.disabled --help

Supported options

Currently, only options for configuring the application URL are supported. The available options depend on the application.

The options are:

  • --appurl /: Move your application URL to / removing the prefix /APP-NAME from the URL. Only the / is accepted and reverting this change using the command line tool is not currently supported.

  • --machine_hostname NAME: Updates your application to use the specified machine hostname NAME (or specified IP address) if it depends on this value to work properly.

Automatic behaviour

The Bitnami Configuration Tool automatically runs on every boot to configure the hostname. Therefore, once you have configured a domain name with the --machine_hostname parameter, you should rename the tool to avoid your configuration being reset on the next boot. Use the commands below to rename the tool:

$ cd /opt/bitnami/apps/APP-NAME
$ sudo mv bnconfig bnconfig.disabled
Last modification May 20, 2025