Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Die Software für die Plattform der Softwerkskammer
JavaScript HTML CSS
Branch: master

Merge pull request #1005 from leider/master

extracting common component for avatar display / editing
latest commit dbc61e78fa
@NicoleRauch NicoleRauch authored
Failed to load latest commit information.
.idea removed jslint from webstorm settings
config activityresults now available in SoCraTes
dev-goodies Another mongo snippet.
socrates Merge pull request #1005 from leider/master
softwerkskammer extracting common component for avatar display / editing
.editorconfig add editorconfig to assist web storm and users with simple editors
.eslintignore eslint now also in softwerkskammer
.eslintrc continue removing jslint from code
.gitattributes Use eol=lf for shell scripts
.gitignore repairing SoCraTes datatables view
.travis.yml try to run travis on nodes 0.12, too
Gruntfile-SoCraTes.js autonumeric now available via npm -> Bower not neccessary anymore
Gruntfile.js autonumeric now available via npm -> Bower not neccessary anymore
LICENSE.txt Added Jan to the copyright list of people. update docu for wikirepo and vagrant under windows
Vagrantfile exposing port for SoCraTes 17224 there are case sensitive filesystems :)
karma-socrates.conf.js change the way socrates members (addon) is checked
karma.conf.js changing the karma istanbul behavior
package.json update deps
start-socrates.js Beamed the SoCraTes pages to this repo
start-softwerkskammer.js change the way the platform is started script to create and synchronize folder /home/vagrant/agora restructured the repository for integration of socrates website


This project comprises a web platform for a Community Server.

There is a companion project where the feature backlog lives. Go to the issues in

Video hangout

Co-ordination via the mailinglist at

What this is about

This is the project to build the new groupware platform for the German Software Craftsmanship Communities. It can be seen in action on The site is currently German only.

Current Build Status

Build Status

New and easy local installation via vagrant

Vagrant is an easy way to set up virtual machines inside your OS with everything needed to get our server up and running.

Just follow these steps:

  1. Download and install Oracle VirtualBox from here:
  2. Download and install Vagrant from here:
  3. Check your version of Vagrant with vagrant --version. 1.5.1 and above are known to work.
  4. Clone, or if you plan to make contributions, fork and clone the repo (forking is a must if you want to contribute)
  5. Open a shell inside the checkout directory
  6. Perform vagrant up - (this will download and provision the virtual machine)
  7. You can then log into the VM via vagrant ssh
  8. You will find the sources inside the VM in a directory /vagrant
  9. So cd /vagrant

Under host OS Windows execute

  1. ./
  2. cd ~/agora

node js modules can not be installed into /vagrant because it is shared with the host OS which does not support links. So every time you change anything on the windows side you should repeat call ./ from either /vagrant or ~/agora and the all of the following steps should run in ~/agora.

Once retrieved perform the following commands inside the directory of the cloned repo:

  1. npm install - this will fetch all dependencies needed
  2. node softwerkskammer/initialDBSetup - this will create some sample data to start with
  3. npm test - will create a few necessary files and perform a complete test suite. This must end successfully!

Prepare log file configuration

  1. Open softwerkskammer/config/example-winston-config.json or socrates/config/example-winston-config.json, depending on which app you want to use
  2. Delete the comment in line 1 (// to use these values, strip "example-" from the filename, delete this comment and replace the below values ), you may keep the content of the file as it is
  3. Save this file as winston-config.json

Now you can decide which app you want to start:

  • Start softwerkskammer

    • node start-softwerkskammer - will start the server
    • Now go to your local machine, open a browser and use http://localhost:17124
  • Start socrates

    • ./ in order to build some css, js etc.
    • node start-socrates- will start the server
    • Now go to your local machine, open a browser and use http://localhost:17224

System requirements and Installation


It is a node.js project. Therefore you need node.js installed. Get it from

You need a current 0.10.x version to run the software.

Your node.js installation must contain at least npm 1.3.

Additional Software

Some modules are compiled during the installation. Therefore some additional software must be installed.


  • Python 2.7 (not Python 3!) in system path
  • For Windows:
    • Make sure that Python and node.js are both either 32 bit or 64 bit - mixed combinations will not work!
    • Add an environment variable PYTHON that points to the Python executable.


  • Install a C++ compiler with headers and libraries (depending on your OS)
    • For Mac OS X: Install XCode from the App Store. In XCode's preferences (section "Downloads"), install the command line tools. When you have installed the stand alone version of the command line tools, you need to execute sudo xcode-select -switch /usr/bin before you are able to run npm install.
    • For Windows 7 and older: Microsoft Windows SDK for Windows 7 and .NET Framework 4 available here
    • For Windows 8 (may also work for Windows 7):
      • Microsoft Visual Studio C++ 2012 for Windows Desktop (Express version works well)


  • Git must be in the system path



We propose to install grunt-cli globally via the -g option of npm. To find out more about this option, see

  • (Optional) To define the installation location of global npm packages on Unix-like Systems create a file called .npmrc with the following contents in your Home directory:

    prefix = GLOBALPATH
    umask = 077
  • Anywhere, invoke npm install -g grunt-cli or sudo npm install -g grunt-cli if you don't have sufficient user privileges. You can check the installation with which grunt. If a location is returned everything is fine.

  • (Optional) If the directory GLOBALPATH/bin is not in your path (you can check with echo $PATH), you need to add it to the path: In your Home directory, create or edit the file .profile and add the following line:

    export PATH=GLOBALPATH/bin/:$PATH

Shell for npm install

  • You need a shell (a.k.a. command line window) that is able to access the stuff you just installed.

  • For Windows 7 and older:

    • The shell must be set up for running the Microsoft C++ compiler, like so:

      cmd.exe /E:ON /V:ON /T:0E /K "C:\Program Files\Microsoft SDKs\Windows\v7.1\Bin\SetEnv.cmd" /Release /X86
  • For Windows 7 or 8:

Preparations for use

  • Check out this project into some folder (let's call it REPO from now on)
  • Open a shell as described above and go to REPO
  • Run npm install

  • If python 3 is the default version, the command line for npm install must be adapted to the right python version (2.7)

        npm install --python=/usr/bin/python2
  • Start mongodb. If you only plan to use it for development, the default settings are ok. The app as well as the tests use these defaults if you did not change the configuration.

  • (Optional) Instructions for authenticated use are here

The built-in wiki

To set up the built-in wiki follow these instructions

Running the server

  • Open a shell in REPO
  • If your installation is fresh, perform the db initialization script:
    • Run node initialDBSetup
  • If your installation is fresh or you changed anything:

    • Run npm test (this creates the CSS files and other static contents and performs jshint checking)
  • Run npm start

  • You can now access the application by entering http://localhost:17124 in your browser

    • The port 17124 is the default and can be changed via the command line option --port or via the environment option 'port' to any desired value
  • If your installation is fresh, you should create an account for yourself by registering.
    • The default setup assumes you are running on localhost for authentication. If you are using a different hostname, you have to edit the configuration file config/example-server-config.json. Follow the instructions in there.

Running the tests

You can run the tests in REPO with npm test


For running specific tests only, you can use mocha in a command like mocha -R spec test/announcements/ To install mocha, invoke npm install -g mocha or sudo npm install -g mocha

To run the style check (jshint) and the tests on every file change, use grunt watch

We are using WebStorm as IDE Webstorm

WebStorm Logo

Feel free to ask us for a community licence if you are contributing.

Editing the stylesheets

Only edit the agora.less file inside the "partials" subfolder. Running npm test or grunt default will compile everything to screen.css.

Something went wrong with that request. Please try again.