dschowta / server Goto Github PK

GOST (Go-SensorThings) is an IoT Platform written in Golang (Go). It implements the Sensing profile (part 1) of the [OGC SensorThings API] (http://ogc-iot.github.io/ogc-iot-api/api.html) standard including the MQTT extension.

Implementation of the Tasking profile (part 2) and Rules Engine profile (part 3) of the OGC SensorThings API is planned as a future work activity.

The GOST website and blog can be found at www.gostserver.xyz

GOST is alpha software and is not (yet) considered appropriate for customer use. Feel free to help development :-)

Current release V0.5: 2017-07-17

Binaries are build for Windows, Ubuntu and OSX.

For benchmarks see http://www.github.com/gost/benchmarks.

For more information about running GOST with Docker-compose, see GOST Docker support.

For more information about running GOST in Raspberry Pi with Docker-compose, see How to run GOST on Raspberry Pi.

For making connection to external database use environmental variables GOST_DB_HOST, GOST_DB_PORT, GOST_DB_DATABASE, GOST_DB_USER, GOST_DB_PASSWORD

$ docker run -d -p 8080:8080 -t -e GOST_DB_HOST=192.168.40.10 -e GOST_DB_DATABASE=gost --name gost geodan/gost

For using your config own file, create a mount:

$ docker run -v myconfiglocation:/gostserver/config geodan/gost -config /gostserver/config/myconfig.yaml

$ docker build -t geodan/gost .

note: building the Raspberry Pi image must be done on a Raspberry Pi :-(, otherwise errors will occur.

$ sudo docker build -f Dockerfile-rpi -t geodan/rpi-gost .

$ sudo docker push geodan/rpi-gost

GOST is being tested against the OGC SensorThings API Test Suite 1.0 https://github.com/opengeospatial/ets-sta10

Status GOST on OGC site: http://www.opengeospatial.org/resource/products/details/?pid=1419

GOST installation

GOST configuration

GOST security

Apiary API Docs

HTTP API: For sample requests (setting up sensors/datastreams/things and adding observations) see the tests in the playground. For a complete collection of working requests install Postman and import the Postman file

MQTT: For getting started with Gost and MQTT for publishing/receiving data see GOST and MQTT - Getting started

• Complete implementation of the OGC SensorThings spec
• Test coverage!
• Frontend
• Benchmarks
• Authentication
• Different storage providers such as MongoDB (Now using PostgreSQL)