Copyright 2018 © karma.run AG. All rights reserved.
Use of this source code is governed by an AGPL license that can be found in the LICENSE file.
karma.run ("karma" for short) is an integrated back-end server solution to power data-driven client applications. It is designed to be easy to use directly from a web browser, IoT or mobile environment.
karma.run comes with batteries included and features such as:
- nested data object models.
- strong serializable consistency.
- powerful ABAC-based access control.
- a relational model with traversable reference graph.
- functional, homoiconic query interface.
Run Karma (Docker)
create a secret key:
The secret is the auth key of the servers "admin" user. In order to run karma you need to generate a secret:
head -c 1024 /dev/urandom | base64
Linux: If you are on Linux use the base64 -w0 flag to strip the newlines out
head -c 1024 /dev/urandom | base64 -w0
pull the image
docker pull karmarun/karma.run
docker run -d \ -e "KARMA_DATA_FILE=/karma-run-db.data" \ -e "KARMA_INSTANCE_SECRET=base 64 encoded secret key" \ -p 8080:80 \ karmarun/karma.run
To install karma.run you need the Go toolchain:
$ go get karma.run
Stable tags will have binary releases.
Get started in 5 minutes
Dependencies & Licenses
karma.run depends on three external software packages:
- github.com/coreos/bbolt (MIT licensed)
- github.com/kr/pretty (MIT licensed)
- golang.org/x/crypto/bcrypt (BSD licensed)
Please see their respective LICENSE files for legal information.