Quick start

Connect2id server requirements

2+ GBytes of RAM
If you expect to service more than 100 thousand users the server will benefit from extra available memory.
Java 11+
Make sure the Java runtime is up to date with the latest security patches.
A database for the server to persist its data, such as a client registrations and sticky grants. MySQL, PostgreSQL, Microsoft SQL Server, H2, LDAP, DynamoDB and Redis are supported.
Java Servlet 3.0+ Container
An Apache Tomcat web server is included in the download package. Other servlet v3.0+ compliant containers are also supported.


Step 1.

Unzip the downloaded Connect2id server package in a suitable directory.

Step 2.

Start the Apache Tomcat web server, which has preinstalled and configured instances of the Connect2id server and an H2 database for persisting its data, a demo login page, an LdapAuth service for authenticating users against an in-memory LDAP directory, and an OpenID Connect client.

To start Apache Tomcat:


To access the Tomcat management panel go to

and enter the following admin credentials:

  • Username: admin
  • Password: secret

Step 3.

Point your favourite browser to the base URL of the Connect2id server:

You should see a banner page, listing the standard OAuth 2.0 / OpenID Connect endpoints provided by the server. There's also a list of server web APIs for integrating UIs and custom components.

Step 4.

Launch the example OpenID Connect client to test authentication and UserInfo retrieval with the Connect2id server:


We also provide an image to evaluate the Connect2id server in a Docker container.

Questions or comments?

Get in touch with Connect2id support.