-
Notifications
You must be signed in to change notification settings - Fork 202
Installing freelan on linux
This guide is currently deprecated and will be rewritten.
This guide will help you to install freelan on your Linux distribution.
If your Linux distribution is not listed here, you probably will have to compile freelan from source. See the dedicated section of this guide for information about that.
If you are interested into packaging freelan for a non-supported distribution or if you know someone who might be, do not hesitate to contact us.
We currently provide a Debian repository for Debian squeeze, wheezy and sid. This repository is hosted at (http://debian.freelan.org).
To enable the repository, add the following line to your /etc/apt/source.list:
# freelan repository (wheezy and sid)
deb http://debian.freelan.org/ sid main
Or for Debian squeeze:
# freelan repository (squeeze)
deb http://debian.freelan.org/ squeeze main
We also recommand that you add the public GPG key for the repository to your local trusted keys list:
wget -q http://debian.freelan.org/debian.freelan.org.key -O- | apt-key add -
Update your package cache, as root:
# apt-get update
# apt-get install freelan
And that's all !
If your distribution is not supported (yet), the only option is to build freelan from source.
You don't necessarily have to be an expert in computer programming to build freelan, however some knowledge about it will surely help. Just give it a try, and if you get stuck, ask your questions on the developers mailing-list.
Freelan is composed of several projects. Namely:
-
libcryptoplus— A C++ wrapper around the OpenSSL cryptographic library. -
libfscp— A library implementing the Freelan Secure Channel Protocol. -
libasiotap— A extension library for Boost/Asio that adds support for virtual TAP adapters. -
libfreelan— The main freelan library that glue all the other libraries together. -
freelan— The main freelan binary, implemented as a Windows Service for Windows, and as a UNIX daemon for Linux/Mac OS. -
freelan-buildtools— The build tools, as a set of Python scripts based on SConstruct.
Note: All these libraries were written for Freelan but may be used independently in other projects. They are all licensed under the GPLv3 licence and their build process is heavily documented. Don't forget to read the README.md and INSTALL.md files when available.
Before you continue, please ensure that your configuration meets the following requirements:
- Python (>= 2.7)
- SConstruct
- gcc (>= 4.5)
- git
- Boost library development files (>= 1.49) (When in doubt, pick the latest)
Get the build-tools git repository from (https://github.com/freelan-developers/freelan-buildtools).
Inside the project directory, type, as root:
# ./setup.py install
If you don't want to setup things in your /usr/local/ directory, you can also add the project root directory to your PYTHONPATH so that it becomes available to any python shell.
Note: Depending on where you intend to install the libraries, you may also have to do it for root.
The steps to build a library are the same for all freelan libraries. You will however have to build and install them in the specified order:
Get the source code for all libraries from their git repositories, then, inside every directory, type:
$ scons
$ scons install prefix=/usr/local/
Depending on the specified prefix you might need root permissions.
The last step is to build the freelan daemon binary. Get the source from its git repository (https://github.com/freelan-developers/freelan) then inside the directory, type:
$ scons
$ scons install prefix=/usr/local/
Depending on the specified prefix you might need root permissions.
And that's it ! Freelan is installed on your linux distribution !