One of the advantages of being a web-based modeling environment is that end-users don’t need be concerned with installing any dependencies on their machine. All they need is a web browser! We aim to support all the major modern browsers. However we recommend using Chrome for a couple of reasons:
- Manual testing is mostly done using chrome
As a developer of a webgme app you will however be required to host your own webgme server and for that you will need to install some dependencies in addition to having access to a browser.
- Node.js (version >= 6, CI tests are currently performed on versions 6.x, 8.x and LTS is recommended).
- MongoDB (version >= 3.0).
- Git (must be available in PATH).
- Python (This is only needed if you intend to write plugins in python - both v2.7.x and v3.x are supported).
When you have followed the instructions below make sure that the command below works and prints v8.12.0 or similar.
- Go to nodejs.org and make sure to download and install the LTS! At the time of writing this that would be version v8.12.0. Alternatively install nvm (node version manager) which enables you to have multiple version of node installed.
- Linux based operating systems (and macOS)
- On linux based systems it is recommended to install node using nvm (node version manager). It allows you to have multiple versions installed. The instructions below are borrowed from d2s’ gist.
- Open new Terminal window.
- Run nvm installer with either curl or wget.
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.5/install.sh | bash
wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.5/install.sh | bash
- If everything went well, open new Terminal window/tab.
- List what versions of Node are currently installed (probably none).
- Install latest Node.js LTS release.
nvm install v8.12.0
Webgme stores the models, project metadata and user info inside a mongo database. The Community edition works fine.
After you’ve followed the instructions and successfully installed mongodb. Either Launch a daemon (mongod) with the default options or pass the dbpath flag to store files at another location.
mongod --dbpath C:\webgmeData
mongod --dbpath ~/webgmeData
For this tutorial you will need to have git installed. On linux/macOS this is typically already installed. Check by typing:
If not installed following the instruction at git’s webpage.
This is only needed if you intend on writing plugins using the python API available via webgme-bindings.
Using webgme-bindings works with both v2.7.x and v3.x, however we recommend to install the latest python 3 version as it already comes packaged with pip which will be needed in order to install webgme-bindings.
Note that here we do not require any Virtual Environment setup for any anaconda. If you’re familiar with any of those and would like to use such approach - it should work perfectly fine as long as the correct python is available in $PATH when you execute your plugin.
- Windows and MacOS
- For Windows and MacOS simply download and install the appropriate latest release at python.org.
- For linux these instructions can be used. Note that
pipexecutables will be available as
pip3, so for any command referring to
pipreplace these accordingly. (In this case you need to update the generated plugin code as well, more about that later…)
When you’ve installed python and pip, make sure both of these commands prints out a version number.