Cluster Management
The Cluster Management feature is the heart of Skycloak, allowing you to create and manage your Keycloak clusters efficiently. From here, you can view your clusters along with the amount of realms and users, access the Keycloak console, view logs, and request advanced features.
Managing Clusters
Creating a New Cluster
- Navigate to the Clusters page
- Click “Create a Cluster” button
- Configure your cluster:
- Name your cluster
- Choose cluster size
- Select Keycloak version
- Set admin credentials
- Click “Create” for the process to begin
Your cluster will be in “Creating” state for a few minutes, and you’ll receive an email notification when it’s ready. If it takes longer than 5 minutes, please contact us.
Accessing the Keycloak Console
- From your clusters list, find the cluster you want to access
- Click the “Go to Console” button
- You’ll be redirected to your Keycloak administration console in a new tab
Cluster Details
Click the “Details” button on any cluster to access:
- Cluster information
- Performance metrics
- Advanced features
- Logs access
Accessing Cluster Logs
- Navigate to cluster details
- Click “Request Logs” button
- A request will be processed to gather your logs
- You’ll receive an email within minutes containing your cluster’s Keycloak logs
Requesting Additional Features
From the cluster details page, you can request:
- Advanced security features (firewalls)
- Custom domain setup
- Custom theme implementation
- Other specialized configurations
Simply click the “Contact Us” button in the relevant section to submit your request.
Cluster Operations
Updating a Cluster
- Access cluster from dashboard or details page
- Click “Edit” button
- Choose new configuration options. You are currently limited to changing the cluster name and version.
Important Version Upgrade Notes:
- Version updates are only allowed to move forward (e.g., 21.0.1 to 21.0.2 or 21.1.0)
- Downgrading to a lower version is not possible due to database schema compatibility issues
- For major version upgrades, we recommend upgrading gradually through minor versions
- Use our Keycloak Upgrade Assistant GPT to help plan your version upgrade path
- Click “Update” button
- Your cluster will be updated within a few minutes and you will receive an email notification.
Deleting a Cluster
- Access cluster dashboard or details page
- Click the checkbox to give your consent to delete the cluster
- Enter the name of the cluster to confirm deletion
- Click “Schedule Deletion” button
Note: This will schedule the deletion of the cluster and you will receive an email notification when it’s done. For data protection purposes, we will keep your cluster’s data for 7 days before deleting it. You will be notified and warned days before deletion. Once deleted, any users from that cluster will be deleted along with the cluster.
You can also cancel the deletion of the cluster if you change your mind at any time before it’s deleted.