Development README Page

Build Status CII Best Practices Coverage Requirements Status IRC Channel$.data.last_month&suffix=/month Help via Isomer Logo

♦ Isomer - Be Collaborative!

A collaborative and modular infrastructure for your data.

  • Geo Information Use a sophisticated map to annotate and review geographical information
  • Vehicle support Attach a sailyacht, your camper or pack one in your backpack
  • Project planning Issue tracking for collaborative teams
  • Modular Expandable with integrated modules or build your own
  • Cloud independent Run nodes on your own infrastructure

Much more incoming!

⛁ Installation

Please be wary of bugs and report strange things, thank you!

► Docker: Yes, please!

If you just want to try it out or generally are happy with using docker, there is no need to clone the repo, just download the docker compose file and get everything from docker hub:

docker-compose -f docker-compose-hub.yml up

See the docker detail page for more information.

☓ Docker: No, thanks..

There is more than one way of installing Isomer, see the detailed instructions for those.

If you intend to set up a development environment, please follow the development workflow instructions.

⊕ Modules

The system is modular, so you can install what you need and leave out other things.

A lot of the included modules are still Work in Progress, so help out, if you’re interested in a powerful - cloud independent - collaboration tool suite.

♨ General modules

These are ‘official’ isomer modules. If you’d like to contribute your own, ping, to get it added to the list.

Some (marked with *) are work in progress and probably not really usable, yet.

Again, help is very welcome!

Name Description
automat* Automation for non programmers
calc* Integrated EtherCalc
calendar* Calendar support
camera Camera support
countables Count arbitrary things
enrol Enrollment/User account management
filemanager* File management
heroic* User achievements and badges
ldap* LDAP user authorization
mail E-Mail support
notifications* Channel independent user notification system
project Project management tools
protocols Miscellaneous communication protocols
sails Web UI, compatible with all modern browsers (integrated)
sessions Session chair module for planning conferences and similar
shareables Shared resource blocking tool
simplechat Very rudimentary integrated chat
transcript* Meeting notes module
wiki Etherpad + Wiki = awesomeness

☕ Work in progress

  • Full GDAL based vector chart support (Currently only raster charts)
  • Dynamic Logbook
  • GRIB data (in charts)
  • Navigation aides, planning
  • Datalog, automated navigational data exchange
  • Crew management, more safety tools
  • wireless crew network and general communications

⚯ Other 3rd party modules

Name Description
avio Creative mixed media suite
library Library management
polls Tool for lightweight internet voting
garden Garden automation tools

↯ Bugs & Discussion

Please research any bugs you find via our Github issue tracker for Isomer and report them, if they’re still unknown.

If you want to discuss distributed, opensource (or maritime) technology in general incl. where we’re heading, head over to our Github discussion forum …which is cleverly disguised as a Github issue tracker.

You can also find us here:


Please be patient when using IRC, responses might take a few hours!

♚ Contributors



  • Fabulous icons by, the noun project and Hackerfleet contributors


  • c-base e.V. our home base, the spacestation below Berlin Mitte
  • Lassulus for hosting and nix expertise
  • Jetbrains s.r.o for the opensource license of their ultimate IDE
  • Github for hosting our code
  • Gitlab for hosting our code ;)
  • Travis.CI for continuous integration services
  • Docker Inc. for providing containerization infrastructure
  • for hosting our documentation
  • BrowserStack for cross device testing capabilities

© License

Copyright (C) 2011-2019 Heiko ‘riot’ Weinen <> and others.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see <>.

– ⛵🖤