Project

General

Profile

strongSwan Installation Documentation » History » Version 52

Tobias Brunner, 25.11.2014 16:10

1 25 Tobias Brunner
h1. strongSwan Installation Documentation
2 1 Martin Willi
3 1 Martin Willi
4 25 Tobias Brunner
5 1 Martin Willi
h2. Live testing system
6 25 Tobias Brunner
7 26 Tobias Brunner
We have built a [[OpenWRTDemo|small test system]] to run strongSwan without installation or configuration. It is based on a UML kernel, two small "OpenWRT":http://openwrt.org/ images and should run on any x86 Linux system out of the box.
8 25 Tobias Brunner
9 25 Tobias Brunner
10 25 Tobias Brunner
h2. Distribution packages
11 25 Tobias Brunner
12 25 Tobias Brunner
13 1 Martin Willi
There are currently packages for:
14 47 Dmitry Korzhevin
* "Arch Linux":https://aur.archlinux.org/packages/strongswan/
15 27 Tobias Brunner
* "Debian":http://packages.debian.org/search?keywords=strongswan&searchon=names&suite=all&section=all
16 31 Andreas Steffen
* "Ubuntu":http://packages.ubuntu.com/search?keywords=strongswan&searchon=names&suite=all&section=all
17 27 Tobias Brunner
* "openSUSE":http://software.opensuse.org/search?p=1&q=strongswan
18 27 Tobias Brunner
* "Gentoo":http://packages.gentoo.org/package/net-misc/strongswan
19 39 Tobias Brunner
* "Maemo":http://maemo.org/packages/view/strongswan/
20 44 Brian Pruss
* "Fedora":http://pkgs.org/download/strongswan
21 44 Brian Pruss
* "Red Hat Enterprise Linux and CentOS via EPEL":http://pkgs.org/download/strongswan
22 1 Martin Willi
23 25 Tobias Brunner
h2. Compile yourself
24 16 Martin Willi
25 16 Martin Willi
26 1 Martin Willi
27 30 Andreas Steffen
h3. Linux Kernel requirements
28 25 Tobias Brunner
29 25 Tobias Brunner
strongSwan should run on most distros' kernels. If you build your own kernel, include [[KernelModules|the required modules]].
30 25 Tobias Brunner
31 25 Tobias Brunner
h3. Building strongSwan
32 25 Tobias Brunner
33 1 Martin Willi
34 43 Tobias Brunner
Since the release of strongSwan 4.x the GNU build system (Autotools) is used to build strongSwan.
35 38 Tobias Brunner
36 50 Tobias Brunner
There is a growing list of configure options available (*note that many of these are enabled by default*):
37 43 Tobias Brunner
38 45 Tobias Brunner
* [[Autoconf|Autoconf options for the most current release]]
39 46 Tobias Brunner
* [[Autoconf46|Autoconf options for 4.6 releases]]
40 1 Martin Willi
41 50 Tobias Brunner
Refer to the [[PluginList|list of plugins]] to learn more about the plugins enabled with the above options.
42 48 Tobias Brunner
43 49 Tobias Brunner
*Note:* Some plugins have dependencies on third-party libraries. To compile such plugins the header files of those libraries are required. Make sure these are installed on your system, e.g. by installing the appropriate _-dev_ package on Debian-based systems. Otherwise, the ./configure script will complain that it can't find the library or header files.
44 40 Tobias Brunner
45 40 Tobias Brunner
46 1 Martin Willi
The build procedure is as with any autotools project:
47 40 Tobias Brunner
48 1 Martin Willi
# "Download strongSwan":http://www.strongswan.org/download.html:
49 1 Martin Willi
<pre>
50 45 Tobias Brunner
 wget http://download.strongswan.org/strongswan-x.x.x.tar.bz2
51 1 Martin Willi
</pre>
52 40 Tobias Brunner
# Unpack the tarball:
53 40 Tobias Brunner
<pre>
54 45 Tobias Brunner
 tar xjvf strongswan-x.x.x.tar.bz2; cd strongswan-x.x.x
55 40 Tobias Brunner
</pre>
56 40 Tobias Brunner
# Configure strongSwan using some of the options above:
57 40 Tobias Brunner
<pre>
58 1 Martin Willi
 ./configure --prefix=/usr --sysconfdir=/etc --<your-options>
59 40 Tobias Brunner
</pre>
60 40 Tobias Brunner
# Build the sources and install the binaries as root:
61 40 Tobias Brunner
<pre>
62 1 Martin Willi
 make
63 1 Martin Willi
 sudo make install
64 1 Martin Willi
</pre>
65 52 Tobias Brunner
66 52 Tobias Brunner
h3. Building strongSwan from the Git repository
67 52 Tobias Brunner
68 52 Tobias Brunner
To build strongSwan from the Git repository additional tools and steps are required, check source:HACKING for details.
69 30 Andreas Steffen
70 33 Tobias Brunner
h3. Building strongSwan on other platforms
71 30 Andreas Steffen
72 51 Tobias Brunner
* [[FreeBSD|strongSwan on FreeBSD]]
73 51 Tobias Brunner
* [[MacOSX|strongSwan on Mac OS X]]
74 51 Tobias Brunner
* [[Android|strongSwan on Android]]