Welcome, Guest Login

Public Cloud Center


Last Updated: Apr 19, 2017 10:32AM EDT

Robomongo is a popular MongoDB management tool that makes it easy to create, edit, and retrieve collections and documents in your MongoDB databases through a GUI.

Note: You will want to be using at least Robomongo v0.9.

This guide will walk you through connecting to a MongoDB database and assumes that you have already created a database on Xervo. You will need two things,

  1. the ID of your database and
  2. the credentials for the user account that you created when you created the database.

To find your database ID proceed to your dashboard, click on the databases menu item on the left

Then select your database from the list.

Then click on the administration menu item for the database.
The connection strings in this dashboard include the database ID.

If you are not sure what your user & password is for the database is you should select the 'users' on the menu to the left.

In the 'users' tab you will see the users on the database, and you can reset the password by selecting the small 'gear wheel' to the right of the username.  Make sure you do not have 'read-only' for the user selected.
Also, make sure you do not have the ' @ ' symbol in your database username or password.

When you select the 'gear wheel' this will pop up:

Adding your database to Robomongo

Once you have downloaded Robomongo:

Open the Robomongo application.
When you open the Robomongo application a little window should pop up which allows you to add/create new database connections.

If the window to add mongo connections does not appear when you open Robomongo click this button

To add your database to Robomongo select the 'create' button here, or 'right-click' and select 'add.'

The 'connection settings' window will now appear.

  • You can enter anything for 'Name' - this will not affect your connection to the mongo.
  • Enter the 'Address' - this should be something like percy.mongo.xervo.io
  • Leave the port as 27017

On the 'Authentication' tab

Select this box if it is not already checked:

Remember the database id you grabbed earlier from the connection string on the 'administration' section of the mongo dashboard? That is the 'database id' for the 'Database' field. Do not mistake this with what you named your database.

  • Enter the 'database id' for the 'Database' field (should be a short alpha-numeric id)
  • Enter the user name you created for your database in the 'User Name' field
    • Do not use the credentials you use to log in to my.xervo.io (unless you use the same username and password to log in to the web dashboard - this is not recommended).
  • Enter the password for that database user.
    • Not sure what the password is? Refer to 'gear wheel' noted above.
  • Make sure you have SCRAM-SHA-1 selected for the 'Auth Mechanism'
  • Select 'Save'

If you forgot the password for the database user, refer to the 'gear wheel' part mentioned above.
Make sure you 'SCRAM-SHA-1' selected for the Auth Mechanism

'SSH' & 'Advanced' tab

Do not enter anything here. Do not enter a default database. Ignore these tabs.

Example 'SSH' tab: (notice: nothing is entered in any field in the screen snip below)

Example 'Advanced' tab: (notice: nothing is entered in any field here either. Do not enter a 'default database,' leave that blank. Don't use this tab. Ignore this tab.

After making sure you ignored and entered nothing in any field on the 'SSH' and 'Advanced' tab, make sure you select 'Save'

Connecting to your database

Now that you have saved your 'Connection Settings' you will be taken back to the 'MongoDB Connections' window. Select the database you want to connect to, and select 'Connect.'

If you run into any trouble or errors submit a support ticket by emailing help@xervo.io
or use the 'Status & Support' menu to the left (by selecting this link): Submit a Support Request

Contact Us

    Our Support Policy
    Submit a Support Request

  • Public Cloud Support Hours
    9am-5pm EST Mon-Fri
    Outside of these hours response times may be up to 24hrs.

    Submit a support ticket by clicking 'status and support' icon on the left side of this page.

seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found