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:

* "Arch Linux":https://aur.archlinux.org/packages/strongswan/

* "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 (*note that many of these are enabled by default*):

* [[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 enabled with the above options.

*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.

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]]

* [[MacOSX|strongSwan on Mac OS X]]

* [[Android|strongSwan on Android]]