Shibboleth Installation

Shibboleth consists of several individual components: the identity provider (IdP), service provider (SP), and discovery service (DS). You may choose to deploy one or more of these components depending on your needs. The instructions listed here only cover installation of the components. You must configure the software after installation.

You should always install the most recent release of any software component.

Before you begin

Prior to installation you should review the Understanding Shibboleth documentation and the introduction to the message flows.
For upgrades, you should review the pages on important changes that may be required to upgrade safely. Links can be found below.

If you have questions during installation you should (in this order):
1. Refer to the installation and configuration documentation
2. Check the troubleshooting guides
3. Check the user's mailing list archive to see if other people have had the same problem and what the solution was
4. Ask a question for help on the user's mailing list

If you are upgrading an IdP or SP which is registered with a federation, you should contact the federation operators, give them access to the new metadata for the entity, and tell them what version of the software you have installed. (Otherwise, they have no way of knowing that you have changed your configuration, and will continue to include your old metadata in any federation metadata aggregate which they publish.)
After installation, you should also subscribe to the Shibboleth Announcement mailing list. This is where announcements about new releases, end-of-life of past releases, and security advisories are distributed.

All software, including archived releases, is available from http://shibboleth.net/downloads/ and each release is accompanied by a detached PGP signature using one of the keys listed in the project's KEYS file.

Installation Instructions

Identity Provider (IdP)

This documentation is for the UNSUPPORTED V2 Identity Provider software which has been superseded.

Install the IdP
Upgrade 2.x

Upgrade from 2.0/2.1 to 2.2
Upgrade from 1.3 to 2.x

Changes in New Releases
New Features

Native Service Provider (SP)

Install on Linux
Install on Mac OS X
Install on Solaris
Install on Windows
Install for Java Servlets

Upgrade from 1.3 to 2.x

Release Notes

Configuration Reference

Discovery Service (DS)

Install into a standard container

Browser not supported