Edit History

InstallationDocumentation

Version 42 (Tobias Brunner, 15.08.2011 14:33)

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
    27
    Tobias Brunner
    
* "Debian":http://packages.debian.org/search?keywords=strongswan&searchon=names&suite=all&section=all






    15
    31
    Andreas Steffen
    
* "Ubuntu":http://packages.ubuntu.com/search?keywords=strongswan&searchon=names&suite=all&section=all






    16
    27
    Tobias Brunner
    
* "openSUSE":http://software.opensuse.org/search?p=1&q=strongswan






    17
    27
    Tobias Brunner
    
* "Gentoo":http://packages.gentoo.org/package/net-misc/strongswan






    18
    39
    Tobias Brunner
    
* "Maemo":http://maemo.org/packages/view/strongswan/






    19
    1
    Martin Willi
    






    20
    1
    Martin Willi
    






    21
    25
    Tobias Brunner
    
h2. Compile yourself






    22
    16
    Martin Willi
    






    23
    16
    Martin Willi
    






    24
    1
    Martin Willi
    






    25
    30
    Andreas Steffen
    
h3. Linux Kernel requirements






    26
    25
    Tobias Brunner
    






    27
    25
    Tobias Brunner
    
strongSwan should run on most distros' kernels. If you build your own kernel, include [[KernelModules|the required modules]].






    28
    25
    Tobias Brunner
    






    29
    25
    Tobias Brunner
    






    30
    25
    Tobias Brunner
    
h3. Building strongSwan






    31
    25
    Tobias Brunner
    






    32
    40
    Tobias Brunner
    
We have changed the build system to autotools for the 4.x releases.






    33
    1
    Martin Willi
    






    34
    41
    Tobias Brunner
    
There is a growing list of [[Autoconf|autoconf options]] available:






    35
    40
    Tobias Brunner
    






    36
    42
    Tobias Brunner
    
* [[Autoconf46| Autoconf options for 4.6 releases]]






    37
    41
    Tobias Brunner
    
* [[Autoconf|Autoconf options for 4.5 releases]] (current)






    38
    38
    Tobias Brunner
    
* [[Autoconf44|Autoconf options for 4.4 releases]]






    39
    40
    Tobias Brunner
    
* [[Autoconf43|Autoconf options for 4.3 releases]]






    40
    28
    Andreas Steffen
    
* [[Autoconf42|Autoconf options for 4.2 releases]]






    41
    1
    Martin Willi
    
* [[Autoconf41|Autoconf options for 4.1 releases]]






    42
    1
    Martin Willi
    






    43
    40
    Tobias Brunner
    
Refer to the [[PluginList|list of plugins]] to learn more about the plugins that can be enabled with the above options.






    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
    40
    Tobias Brunner
    
# "Download strongSwan":http://www.strongswan.org/download.html:






    49
    1
    Martin Willi
    
<pre>






    50
    1
    Martin Willi
    
 wget http://download.strongswan.org/strongswan-4.x.x.tar.bz2






    51
    40
    Tobias Brunner
    
</pre>






    52
    40
    Tobias Brunner
    
# Unpack the tarball:






    53
    40
    Tobias Brunner
    
<pre>






    54
    40
    Tobias Brunner
    
 tar xjvf strongswan-4.x.x.tar.bz2; cd strongswan-4.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
    30
    Andreas Steffen
    






    66
    33
    Tobias Brunner
    
h3. Building strongSwan on other platforms






    67
    30
    Andreas Steffen
    






    68
    30
    Andreas Steffen
    
* [[FreeBSD|strongSwan on FreeBSD]] (IKEv2 only)






    69
    1
    Martin Willi
    
* [[MacOSX|strongSwan on Mac OS X]] (IKEv2 only)






    70
    33
    Tobias Brunner
    
* [[Android|strongSwan on Android]] (IKEv2 only)