Skip to content

About the configuration files

ereOn edited this page Apr 26, 2012 · 3 revisions

Freelan's configuration relies on a configuration file whose format and parameters are mostly the same across all the operating systems.

This guide will list the minor differences between the operating systems.

Freelan, by default, provides a reference configuration file. Note that this configuration file, while complete, is not functionnal: it lacks information about the certificates to use and thus require modifications to be used.

This reference unmodified configuration file can be found here should you need it.

Windows

On Windows, you can only have one configuration file and thus, you can only connect to one network. While sufficient in most cases, this limitation will however disappear in a close future.

This configuration file lies in the freelan installation path (default is C:\Program Files\Freelan). Go to this directory:

Freelan files

Then open the config folder.

You need administrative permissions to edit the file.

To refer to an external file in the configuration (for instance, a path to a certificate file), specify a path relative to the freelan installation path with forward slashes instead of backward slashes.

That is, if you store a file at C:\Program Files\Freelan\config\mycert.crt you can refer to it in the configuration file as config/mycert.crt.

Linux

On Linux, freelan currently supports an unlimited number of different configuration files. You can thus connect to several networks simultaneously. A different freelan instance will be launched for each configuration file/network.

A template configuration file is located at /etc/freelan/freelan.conf.

All configurations file must lie directly in the /etc/freelan/ directory and have a .conf suffix.

To refer to an external file in the configuration (for instance, a path to a certificate file), specify an absolute path.

That is, if you store file at /etc/freelan/certificates/mycert.crt you can refer to it in the configuration file as /etc/freelan/certificates/mycert.crt.

Note to Debian users

On Debian, the freelan daemon is started by calling the /etc/init.d/freelan script. This script first parses /etc/default/freelan to check for its options.

If you want the freelan daemon to create a freelan instance for a configuration file, you must enable this configuration by adding to the CONFIGURATIONS environment variable in /etc/default/freelan.

As an example. If you have two configurations, respectively /etc/freelan/mynetwork1.conf and /etc/freelan/mynetwork2.conf, you should set CONFIGURATIONS to the following value in /etc/default/freelan:

CONFIGURATIONS="network1 network2"

Don't forget to stop the daemon before editing this file and to restart it after you have done the change.