Getting started with grunt



Install the default nodejs of your distribution via your favourite package/ports manager and you are good to go.

If you are having problems or your package manager does not provide at least nodejs in version 0.10.x please have a look at

Using Debian/Ubuntu you should install nodejs-legacy to get the node executable as node is some hamradio software


Head to the node.js site and download and install the latest version. It is recommended to restart after the installation, as paths may not be up-to-date.

Please also make sure git is installed and in your PATH.

This is sometimes a problem on windows, make sure to activate the option to put git into your path during msys-git installation.

Mac OS X

We strongly encourage you to use homebrew. Actually, we won't support you if you don't. It's that bad.

Make sure you have an up-to-date homebrew installation.

brew update
brew upgrade

Check your homebrew installation with brew doctor and resolve any issues and repeat this step until homebrews output says "Your system is ready to brew.".

brew doctor

Install node via brew install node if is not yet installed.

brew install node

Make sure you never sudo anything related to node or its package manager npm. If you think you have to, you are doing something wrong and are probably dealing with a broken homebrew/macports installation! If this is the case, the easiest way of resolving this is completely deleting the homebrew (and if present macports) directories and (re)installing homebrew.

The default system's max opened file limit in mac os x is very low (256), in order to use grunt watch, it needs to be increased.

You can either set this in your shell via ulimit -n 8192 to a sensible value.

ulimit -n 8192

or you can set it permanently by adding limit maxfiles 8192 20480 to /etc/launchd.conf

echo "limit maxfiles 8192 20480" | sudo tee -a /etc/launchd.conf

Note that you will have to restart your system for the setting to be active.

Grunt & Bower

With npm install -g bower grunt-cli you can install the global npm dependencies needed for grunt and bower.

Mac OS X / Windows:

npm install -g bower grunt-cli

Linux only: You may need root privileges to install global npm modules.

sudo npm install -g bower grunt-cli

Cleaning development environment

Sometimes it is needed to completely wipe all old and ignored (by git) files. You can also do this using git by running git clean -ndx this will print a lot of files, but _not_ delete any. Check the list if you really want to remove these files. Then run git clean -fdx to really do the cleanup.

Installing node dependencies for OX Appsuite Frontend development

Change to the ui directory of your git workdirectory and run npm install. Make sure, you have got the git binary in your path. (This is sometimes a problem on windows, make sure to activate the option to put git into your path during msys-git installation. TODO: more detail)

npm install

Building the UI

Just run the default grunt task grunt


Local configuration

You can override some options on your local build environment by creating the file grunt/local.conf.json. See grunt/local.conf.default.json as a template.

Hint: use grunt show-config:local --output grunt/local.conf.json to generate grunt/local.conf.json.

If you want to use the proxy function of the appserver, at least the server-variable needs to be configured.

    "appserver": {
        "server": "",
        "verbose": ["local:error"]

Accessing the UI

You can run the appserver with the connect grunt task:

grunt connect:server:keepalive

or in combination with the watch task:

grunt connect watch

You can now access the ui via http://localhost:8337/appsuite/.