Getting Started
Install and configure JOSSO EE in minutes
Prerequisites
-
Java 11 or higher (OpenJDK recommended) - Docker and Docker Compose (for containerized deployment)
- Minimum 4GB RAM, 2 CPU cores
- Network access for identity provider integration
Installation Steps
Download JOSSO EE
Download the latest JOSSO EE distribution package from the releases page or contact our team for access.
Configure Environment
Set up your environment variables and configure the database connection for identity storage.
Deploy the Appliance
Deploy JOSSO using Docker, Kubernetes, or as a standalone appliance on your preferred cloud platform.
Access the Console
Open the JOSSO management console to configure your first identity appliance and service providers.
Deployment Options
Docker Deployment
Quick deployment using Docker containers with docker-compose for development and production.
docker-compose up -d josso-ee 
Cloud Deployment
Deploy on AWS, Azure, or GCP using our cloud-optimized images and Terraform modules.
terraform apply -var="cloud_provider=aws" 
On-Premises
Traditional deployment on your own infrastructure with full control over the environment.
./josso-ee-server start First Configuration
1. Access the Management Console
After deployment, access the JOSSO management console at:
https://your-domain:8443/josso/console 2. Create an Identity Appliance
An Identity Appliance is the core component that handles authentication and identity management. Create your first appliance from the console dashboard.
3. Configure Service Providers
Add your applications as Service Providers using SAML 2.0, OAuth 2.0, or OpenID Connect protocols.
4. Test Single Sign-On
Verify your configuration by testing SSO between your applications and the JOSSO identity provider.
