Bargate utilises two configuration files:

  • bargate.conf - the main configuration file
  • shares.conf - a list of file shares your users can access


On startup bargate looks in the following locations for a config file:

  • /etc/bargate.conf
  • /etc/bargate/bargate.conf
  • /opt/bargate/bargate.conf

Once it finds a config file it stops searching, e.g. if /etc/bargate.conf exists then the other config file locations are not checked.

Once you have installed bargate you will need to create a configuration file. Copy the sample config file to get started:

mkdir /etc/bargate
cp /opt/bargate/doc/bargate.conf.example /etc/bargate/bargate.conf

The above command assumes you installed bargate into /opt/bargate

The minimum options you’ll need to set are:

bargate.conf is treated as a Python file - all configuration must adhere to Python syntax.

See Configuration options for a complete list of options to set.


Bargate should be configured with a list of file shares to present to the users, otherwise only ‘Connect to server’ (i.e. enter manually) functionality is available. These shares are configured in the shares config file, usually /etc/bargate/shares.conf (this path is configured via the SHARES_CONFIG parameter).

See Shares configuration to understand the syntax of this configuration file.

Once configured you’ll need to override the dropdown-menus.html template as well.

There is a sample config file included with Bargate. Assuming bargate is installed in /opt/bargate you can use this command to get started:

cp /opt/bargate/doc/shares.conf.example /etc/bargate/shares.conf