Hello there!

Need Help? We are right here!

Support Icon
miniOrange Email Support
success

Thanks for your Enquiry. Our team will soon reach out to you.

If you don't hear from us within 24 hours, please feel free to send a follow-up email to info@xecurify.com

Search Results:

×

Set Up miniOrange On-Premise IAM Server Using AWS Marketplace AMI


This guide outlines the steps to deploy the miniOrange IAM On-Premise Server using either the BYOL or Contract AMI from the AWS Marketplace. It walks you through the launching AMI, configuring the server and database, setting up the initial admin account, and logging into the miniOrange admin dashboard to complete the setup of miniOrange on-premise identity platform on AWS.


Get Free Installation Help


miniOrange offers free help through a consultation call with our System Engineers to set up our on-premise server.

For this, you need to just send us an email at idpsupport@xecurify.com to book a slot and we'll help you in no time.



Follow the step-by-step guide given below for On-Premise IDP AMI from AWS Marketplace



Prerequisites

Before launching, ensure your EC2 Security Group has the following inbound rules:

Port Protocol Description
22 TCP SSH access
443 TCP HTTPS (application)

1. Launch the AMI

  • Launch the instance from the AWS Marketplace. Once the instance is in the Running state, note the Public IP address.

2. Access the Application

  • Open your browser and navigate to:
https://<your-public-ip>

Note: You will see a browser warning for the self-signed certificate — this is expected. Accept and proceed.


3. Complete First-Time Setup

The setup wizard will ask for your database, cache, and message queue connection details. All services are pre-installed and running locally on the instance. Use the following values:

Database (PostgreSQL)

Field Value
Hostlocalhost
Port5432
Databaseminiorange
Usernamepostgres
Password(see /home/ec2-user/ami.env.sh on the server)

Cache (Redis)

Field Value
Hostlocalhost
Port6379

Message Queue (RabbitMQ)

Field Value
Hostlocalhost
Port5672
Usernameadmin
Password(see /home/ec2-user/ami.env.sh on the server)

Complete the wizard and save the configuration.

4. Restart Services

After saving the setup, SSH into the instance and restart all microservices so they pick up the new configuration:

        
         ssh -i your-key.pem ec2-user@<your-public-ip>
         sudo moctl service restart
        
    

Wait about 2-3 minutes, then refresh the application in your browser.

5. Verify Everything is Running

moctl service status

All services should show as active/running.

Optional: Set Server Base URL (Branding)

If you want to use a custom domain (e.g. https://sso.yourcompany.com) instead of the public IP:

  • Log in to the miniOrange IDP admin console.
  • Click the gear icon in the top-right corner.
  • Go to Settings.
  • Update Server Base URL with your desired domain or IP.
  • Save.

Note:

If using a custom domain, ensure your DNS points to this instance's public IP and update your SSL certificate in /etc/nginx/conf/.


Connection Details Reference

All service connection details are stored on the instance at:

/home/ec2-user/ami.env.sh

SSH into the instance and run:

sudo cat /home/ec2-user/ami.env.sh

1. Access the AWS Marketplace Listing

2. Launch miniOrange IDP AMI

Navigate to the pricing details.

  • Select your desired contract duration.
  • Choose any of the 3 license plans.
  • Enter the number of user licenses you wish to purchase. The displayed price is per user for the selected contract duration.
  • Important: Keep auto-renewal enabled to ensure uninterrupted service after your contract expires.
  • Enter the number of user licenses you wish to purchase. The displayed price indicates per user pricing for the selected contract duration.
Pricing details section with license plan and license options

  • Once you’ve verified your license details, click Subscribe. It may take a few moments to create your contract license.
  • After the subscription is complete, you’ll see an option to Launch miniOrange IDP AMI. Click it to launch your instance.

3. Verify Reachability

  • Confirm that http://<public-ip-of-machine>:8080 is reachable.

4. Create IAM Policy For IDP AMI in AWS

  • Go to the AWS Console >> IAM >> Policies.
  • Click on Create policy and paste the following JSON:
  •                 
                        {
                        "Version": "2012-10-17",
                        "Statement": [
                          {
                            "Sid": "VisualEditor0",
                            "Effect": "Allow",
                            "Action": "license-manager:*",
                            "Resource": "*"
                          }
                        ]
                    }
                    
                

5. Create IAM Role For IDP AMI

  • Go to the AWS Console >> IAM >> Roles.
  • Click on Create role.
  • Choose Custom Trust and enter the JSON below.
  • Click Next and select the policy you created in the previous step.
  • Review the role details and then create the role.
  •                 
    
                    {
                        "Version": "2012-10-17",
                        "Statement": [
    
                        {
                            "Effect": "Allow",
                            "Principal": {
                                "Service": "ec2.amazonaws.com"
                            },
                            "Action": "sts:AssumeRole"
    
                        }
                    ]
                }
                

    Select trusted entity type options

6. Modify IAM Role for miniOrange IDP EC2 Instance

  • Go to the AWS console >> EC2 Instances.
  • Search for your miniOrange EC2 machine using its public IP address and click on it.
  • Click on Actions >> Security >> Modify IAM Role.
  • Choose the role you created in the earlier step and click Update IAM role.

7. SSH into the Machine and Run Command

  • SSH into your machine.
  • Run the following command:
  • sudo chown -R mo-idp:mo-idp /opt/mo-idp-server-ami-4.10.1/moas

8. Access miniOrange IDP DB Setup Page

  • Go to http://<public-ip-of-machine>:8080. You will be prompted for the database setup page.

9. Configure and Setup Database

To Configure database :

  • By default, miniOrange AMI has a PostgreSQL database on the same machine. For that You need to create a database and set a new password for the postgres user.
    • Run the following commands:
      • sudo -u postgres psql
      • ALTER USER postgres WITH PASSWORD <enter-password>
  • If you have a database on a separate machine then make sure that the db is set up and the port is open for the IDP machine.

To Setup Database :

  • Go to http://<public-ip-of-machine>:8080
  • Enter the database details on the setup page.
  • Once completed, you will be prompted to set up an admin account.
  • After the admin account is set up, you will see the IAM admin dashboard.

10. Setup miniOrange services

  • Follow the instructions here from 3rd step: Starting Accessory Services to setup services.

Further References

Want To Schedule A Demo?

Request a Demo
  



Our Other Identity & Access Management Products