strongSwan

{{title(strongSwan Installation Documentation)}}

h1. strongSwan Installation Documentation

h2. Distribution packages

There are currently packages for:

* "Arch Linux":https://www.archlinux.org/packages/?sort=&q=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":https://packages.gentoo.org/packages/search?q=strongswan

* "Fedora":https://apps.fedoraproject.org/packages/strongswan/overview/

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

* "FreeBSD":https://www.freshports.org/security/strongswan/

* "Homebrew":https://formulae.brew.sh/formula/strongswan#default (macOS)

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 from the Git repository

To build strongSwan from the Git repository additional tools and steps are required, check source:HACKING for details.

h3. Building strongSwan on other platforms

* [[FreeBSD|strongSwan on FreeBSD]]

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

* [[Android|strongSwan on Android]]

h2. Configuration Management for strongSwan

If you use CM to manage software, there are some options available to help configure strongSwan.

h3. Chef

Useful cookbooks include:

* "strongswanaws":https://supermarket.chef.io/cookbooks/strongswanaws

* "strongswan-base":https://supermarket.chef.io/cookbooks/strongswan-base

h3. Puppet

Useful modules include:

* "Nextdoor/strongswan":https://forge.puppetlabs.com/Nextdoor/strongswan

* "jpds/strongswan":https://forge.puppetlabs.com/jpds/strongswan