|
||
---|---|---|
.circleci | ||
shared | ||
.editorconfig | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
docker-compose.yml | ||
LICENSE | ||
package.json | ||
README.md |
offen
The offen analytics software
This repository contains all source code needed to build and run offen, both on the server as well as on the client. See each of the READMEs in the subdirectories for instructions on how to work on that particular area of the application.
Development of offen has just started, so instructions are rare and things will stay highly volatile for quite some while. Also do not use the software in its current state as it is still missing crucial pieces in protecting the data end to end.
Guidelines for running and developing the Software will be added when it makes sense to do so.
Project planning and issue tracking is done using Pivotal Tracker, but feel free to open a GitHub issue if you have a question or found a bug.
Developing the application
Local cookies and SSL
In local development offen requires to be served both via SSL (in order to use window.crypto) as well as a local.offen.dev
host.
This requires the following steps to be taken:
- Edit your
/etc/hosts
to include the following line:
127.0.0.1 local.offen.dev
- Install and setup mkcert. Assuming you have Go installed, this looks like:
$ go get -u github.com/FiloSottile/mkcert
$ mkcert -install
- Navigate into the repository root and create a local certificate and key for the
local.offen.dev
host:
$ mkcert local.offen.dev
You can test setup by starting the application:
$ docker-compose up
Now you should be able to access https://local.offen.dev:8080/status in your browser without any security warnings.
License
MIT © offen