๐Ÿ“ฆ Turbo87 / ogn-web-gateway

๐Ÿ“„ README.md ยท 69 lines
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69ogn-web-gateway
==============================================================================

[![Build Status](https://travis-ci.org/Turbo87/ogn-web-gateway.svg?branch=master)](https://travis-ci.org/Turbo87/ogn-web-gateway)

[OpenGliderNet] Web-Gateway

[OpenGliderNet]: http://wiki.glidernet.org/

This project contains a webserver that connects to the [OpenGliderNet],
saves the received records to a database for 24 hours and relays all data to
any connected WebSocket clients.


Installation & Usage
------------------------------------------------------------------------------

ogn-web-gateway is using the in-memory database [Redis] as the data store for
the History API. Before attempting to install ogn-web-gateway make sure to
have a working Redis server running.

Next, you should clone this repository using [git]:

```bash
git clone https://github.com/Turbo87/ogn-web-gateway.git
```

Before continuing make sure to set the `REDIS_URL` environment variable so
that ogn-web-gateway known what Redis server it should try to connect to:

```bash
export REDIS_URL=redis://localhost
```

Finally we can use [cargo] to download all necessary dependencies, compile the
application and then run it:

```bash
cargo run --release
```

By default ogn-web-gateway does not produce any console output when running,
so don't be surprised. Once it is running you should be able to visit
<http://127.0.0.1:8080/api/status> to verify that everything runs correctly.

[Redis]: https://redis.io/
[git]: https://git-scm.com/
[cargo]: https://doc.rust-lang.org/cargo/


API Documentation
------------------------------------------------------------------------------

For the API documentation please have a look at the [`docs`](docs) folder.  


License
------------------------------------------------------------------------------

This project is licensed under either of

 - Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
   <http://www.apache.org/licenses/LICENSE-2.0>)
   
 - MIT license ([LICENSE-MIT](LICENSE-MIT) or
   <http://opensource.org/licenses/MIT>)

at your option.