Mac OS X (10.6+)
Linux (64-bit)
Linux (32-bit)



On Windows, MongoProc comes packaged with two shortcuts: one for GUI mode and one for Console mode. Opening either of these will start MongoProc.

Mac OS X

On Mac OS X, MongoProc comes in the form of an application bundle. All you need to do is double click on the green leaf.

If you wish to run MongoProc in console mode, you must take the following steps:

  1. Open Terminal or any terminal like application
  2. cd to the directory that is in
  3. Execute './ --console'


On Linux, MongoProc comes with a shell script called Executing this will open MongoProc in GUI mode. To open it in Console mode, just execute './ --console'.
Note: Make sure is executable (chmod +x

Logging In

Starting up MongoProc presents you with a login dialog.

MongoProc Login

You must login with the same credentials you use to access MongoDB University

MongoProc Login with Credentials



After logging in with MongoProc, you have the ability to configure server settings from within the application.

Using the + and - buttons, you can add and remove as many servers as you would like. MongoProc comes with two servers by default: one destined for a web server at localhost:8082 and one destined for a mongod instance at localhost:27017

MongoProc Server Settings

Here you can configure the server's name, address (host), and port.

Network Proxy

If you require a proxy to access resources on the internet, then you may want to configure MongoProc to use a proxy. This is accomplished by editing the user_settings.json file. The location of this file varies by OS and is provided below.

MongoProc Proxy Settings

To configure a proxy you must edit the proxy field. Provided below are various configurations for different types of proxies.

MongoProc will tell you if a proxy connection has failed.

Testing/Submitting an Assignment

After completing an assignment that uses MongoProc, you will want to test and submit your assignment using MongoProc. In order to do so, navigate to the assignment using the left-side pane.

MongoProc Assignment

The test button will perform the same validation as the grade button except you will not actually be submitting an attempt. This is useful to check if you have done the assignment correctly. It also allows for iterative development on your assignments. Both test and grade will provide you with feedback relating to the assignment at hand. This feedback ranges from error messages to messages letting you know everything looks good.

MongoProc Feedback

When you are ready to submit your assignment for a grade, just click grade and you're good to go!

Common Issues