Prepare the servers
This is not a comprehensive platform implementation guide. These sample setup instructions show a minimal integration of platform components to get you started. The ForgeRock Identity Platform offers maximum extensibility and flexibility in self-managed deployments. The platform includes many features and options these sample setup instructions do not cover. If you don’t need maximum extensibility and flexibility, there are simpler alternatives:
For help with your deployment and to validate your plans before deploying in production, contact ForgeRock. |
Downloads
The sample deployments use software from the ForgeRock Download Center and other locations.
Download the required files for your sample deployment:
Component | Downloads |
---|---|
AM |
|
DS |
|
IDM |
|
IG |
|
Platform UI3 |
|
1 Download this from the Apache site; ForgeRock does not ship Apache software.
2 Separate identity stores deployment only. Download these from the MySQL site; ForgeRock does not ship MySQL software.
3 (Optional) The alternative is to pull the Platform IU Docker images.
Basic requirements
These basic evaluation requirements concern the sample deployments.
Before deploying the platform in production, make sure the deployment meets all the requirements for each server component product. For details, refer to the release notes for each product.
Memory and disk space
These are basic sizing requirements for each sample deployment:
-
Reserve 1 GB RAM for each server product you install.
-
Reserve at least 10 GB disk space for the files.
-
For DS, reserve 5% + 1 GB of the filesystem size as free disk space.
Production deployments may have very different requirements. |
Operating systems
Common supported operating systems for the server component products include:
-
Microsoft Windows Server
-
Red Hat Enterprise Linux and Rocky Linux
-
Ubuntu Linux
For details, refer to the release notes for each product.
Although it is not a supported operating system for the platform, you can try the sample deployments on Apple macOS. |
Java
Supported Java versions for the sample deployments include:
-
Java 17.0.8 or later
Before installing the servers, set the JAVA_HOME
environment variable.
Keep your Java installation up-to-date with the latest security fixes. Some security features may require later updates.
For details, refer to the release notes for each product.
Hosts and ports
The sample deployments use these hostnames and port numbers:
Component | Hostname | Port numbers |
---|---|---|
AM |
|
HTTP: |
DS |
|
Admin: LDAP: LDAPS: |
IDM |
|
HTTP: HTTPS: |
IG |
|
HTTP: HTTPS: |
Platform Admin UI |
|
HTTP: |
Platform End User UI |
|
HTTP: |
Platform Login UI |
|
HTTP: |
Sample deployment on a single computer
The sample deployments assume all servers are deployed on their own hosts.
To try a sample deployment on a single computer, the recommended alternative is to use the ForgeOps Cloud Developer’s Kit (CDK) on Minikube. If you nevertheless choose to demonstrate these sample deployments on your computer,
add aliases for the fully qualified domain names used for the servers and platform UIs
to your
|