-
Notifications
You must be signed in to change notification settings - Fork 202
About the configuration files
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.
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:
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
.
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
.
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.