strongSwan

h1. strongSwan Installation Documentation

h2. Live testing system

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.

h2. Distribution packages

There are currently packages for:

* "Debian":http://packages.debian.org/search?keywords=strongswan&searchon=names&suite=all&section=all

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

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

* "Gentoo":http://packages.gentoo.org/package/net-misc/strongswan

* "Maemo":http://maemo.org/packages/view/strongswan/

* "Fedora":http://pkgs.org/download/strongswan

* "Red Hat Enterprise Linux and CentOS via EPEL":http://pkgs.org/download/strongswan

h2. Compile yourself

h3. Linux Kernel requirements

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

h3. Building strongSwan

Since the release of strongSwan 4.x the GNU build system (Autotools) is used to build strongSwan.

There is a growing list of configure options available:

* [[Autoconf|Autoconf options for the most current release]]

* [[Autoconf46|Autoconf options for 4.6 releases]]

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

The build procedure is as with any autotools project:

# "Download strongSwan":http://www.strongswan.org/download.html:

<pre>

 wget http://download.strongswan.org/strongswan-x.x.x.tar.bz2

</pre>

# Unpack the tarball:

<pre>

 tar xjvf strongswan-x.x.x.tar.bz2; cd strongswan-x.x.x

</pre>

# Configure strongSwan using some of the options above:

<pre>

 ./configure --prefix=/usr --sysconfdir=/etc --<your-options>

</pre>

# Build the sources and install the binaries as root:

<pre>

 make

 sudo make install

</pre>

h3. Building strongSwan on other platforms

* [[FreeBSD|strongSwan on FreeBSD]] (IKEv2 only)

* [[MacOSX|strongSwan on Mac OS X]] (IKEv2 only)

* [[Android|strongSwan on Android]] (IKEv2 only)