Steps to set up miniOrange On-premise Server from an AWS image(with Postgres9.6 as database)

This document includes steps for setting up the miniOrange on-premise server once you have deployed the AWS image. 

Please read the entire document and let us know if you have any questions. 


Step 1: Steps for setting up the admin account of the miniOrange On-premise server in your AWS machine

           1)  Run the following commands on your AWS machine terminal:

cd /usr change directory to usr
cd mo-idp-server-3.3.0/bin navigating to the bin folder in the miniOrange On-Premise server’s directory
sudo su switching to the “root” user
bash starting tomcat

                 On successfully starting up, you will see a message like this(below):

          2)  Now, go to your browser and hit the following url: <your aws dns>:8080/

                This will open a Setup Admin Account Page on your Browser (the page might look similar to the image attached below)


          3) Enter the details asked on this page and click on the Create Account button to continue.


          4) After creating an account, you will be redirected to the login page (see image above). Please enter the details that you used while setting up the Admin account to log in to your miniOrange dashboard.

Step 2: Please run the below commands in your Linux terminal in order to configure Postgres database:

         1) Run the below commands to change postgres user’s Linux Password

  • sudo passwd postgres

        2) Run the following commands to set a password for the postgres database user. Replace the newpassword with a strong password(note: the new    password cannot contain any special characters). Restart the postgresql service again after executing these commands ()

  • su – postgres
  • psql -d template1 -c “ALTER USER postgres WITH PASSWORD ‘newpassword’;”

Note that this user is distinct from the postgres Linux user. The Linux user is used to access the database, and the PostgreSQL user is used to perform  administrative tasks on the databases. This password will be used to connect to the database in the future steps.

      3) Creating a new Database

  • createdb mydatabase  Creates a new database with mydatabase name

     4) Connect to your Database:

  • psql <your_databse_name> Connects to your database

Once you have finished using the shell, you can exit with /q


If you have any questons or if you are facing any difficulties setting up our on-premise server, please feel free to reach out to us by either dropping a mail at or by clicking on Contact us.