Web based graphical domain specific modeling environments

Getting started

Options to deploy and run WebGME:

  1. Fetch the latest version from git directly and start using it
  • install packages with npm npm install
  • launch mongod (>=2.6) locally
  • start the server npm start
  1. Use WebGME as a library
  • install webgme npm install webgme
  • create an app.js file and a config.js
    // app.js 
    var gmeConfig = require('./config'),
        webgme = require('webgme'),
    myServer = new webgme.standaloneServer(gmeConfig);
    myServer.start(function () {
        //console.log('server up'); 
    // config.js 
    var config = require('webgme/config/config.default'),
        validateConfig = require('webgme/config/validator');
    // Overwrite options as needed 
    config.server.port = 9091;
    config.mongo.uri = 'mongodb://';
    module.exports = config;
  • launch mongod locally
  • start the server node app.js
  1. For more complex usages see webgme-boilerplate
  2. If you have Docker installed: docker run -p <port>:80 -d webgme/compact, where is the public host port to be used (e.g.: 80)

After the webgme server is up and there are no error messages in the console. Open a valid webgme address in the browser. The default is, you should see all valid addresses in the console where you started webgme.

Command line interface

All runnable javascript programs are stored in the src/bin directory, you should start them with node from the root directory of the repository, e.g. node src/bin/start_server.js starts the web server. Each script supports the --help or -h command line parameter, which will list all possible parameters.

  • start_server.js: it starts a web server, which opens a connection to the configured MongoDB.
  • run_plugin.js: executes a plugin via a direct MongoDB connection.
  • merge.js: merges two branches if there are no conflicts.
  • usermanager.js: manages users, organizations, and project authorization (read, write, delete).
  • export.js: exports a (snapshot of a) branch into a json file.
  • import.js: imports a (snapshot of a) branch into a webgme project.
  • parse_xme.js outdated: parses a desktop GME xme file and imports it into a webgme database.
  • serialize_to_xml.js outdated: creates a desktop GME xme file from a given webgme project.


  • Plugins - Model interpretation for e.g. code generation.
  • AddOns - Continuous model interpretation for e.g. constraint evaluation.
  • Executor - Code execution framework.




See the LICENSE file.