2023-06-22 17:01:41 +02:00
|
|
|
<p align="center">
|
2023-06-23 14:25:16 +02:00
|
|
|
<img width="400" src="./misc/resources/logo.svg" />
|
2023-06-22 17:01:41 +02:00
|
|
|
</p>
|
|
|
|
|
|
2023-02-02 10:55:24 +01:00
|
|
|
Control plane for "edge" (and OpenWRT-based) devices.
|
|
|
|
|
|
|
|
|
|
> ⚠ Emissary is currently in a very alpha stage ! Expect breaking changes...
|
|
|
|
|
|
2024-02-27 14:14:30 +01:00
|
|
|
## Quickstart
|
|
|
|
|
|
|
|
|
|
**Dependencies**
|
|
|
|
|
- [Go >= 1.21](https://go.dev/)
|
|
|
|
|
- `GNU Make`
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
# Start server and a local agent
|
|
|
|
|
make watch
|
|
|
|
|
|
|
|
|
|
# In a second terminal, create a api token, an admin token and a tenant
|
|
|
|
|
make .emissary-token
|
|
|
|
|
|
|
|
|
|
# Claim the agent for your newly created tenant
|
|
|
|
|
make claim-agent
|
|
|
|
|
|
|
|
|
|
# Query you agents
|
|
|
|
|
./bin/server client agent query
|
|
|
|
|
```
|
|
|
|
|
|
2023-02-02 10:55:24 +01:00
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
### Manually
|
|
|
|
|
|
|
|
|
|
Download the pre-compiled binaries from the [releases page](https://forge.cadoles.com/arcad/emissary/releases) and copy them to the desired location.
|
|
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
|
|
|
|
See [`doc`](./doc/README.md)
|
|
|
|
|
|
2023-06-23 14:42:25 +02:00
|
|
|
## Licence & mentions
|
2023-02-02 10:55:24 +01:00
|
|
|
|
2023-06-23 14:42:25 +02:00
|
|
|
[AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html#license-text)
|
|
|
|
|
|
|
|
|
|
Logo by [@aardouin](https://forge.cadoles.com/aardouin)
|
