Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/codexlynx/systemd-rest

:gear: A minimal HTTP REST interface for systemd.
https://github.com/codexlynx/systemd-rest

daemon http linux rest-api service system-programming systemd

Last synced: 9 days ago
JSON representation

:gear: A minimal HTTP REST interface for systemd.

Awesome Lists containing this project

README

        

## systemd-rest / A minimal HTTP REST interface for systemd.
[![](https://github.com/codexlynx/systemd-rest/workflows/CI/badge.svg)](https://github.com/codexlynx/systemd-rest/actions) [![AUR](https://img.shields.io/github/license/codexlynx/systemd-rest)](LICENSE) [![](https://goreportcard.com/badge/github.com/codexlynx/systemd-rest)](https://goreportcard.com/report/github.com/codexlynx/systemd-rest)

### Architecture:
This service communicates with systemd via dbus (IPC). ```http <-> systemd-rest <-> dbus <-> systemd```

### Features:
* Manage units (start, stop, status)
* List units
* Read unit journal

### Configuration:
Currently configured using environment variables.

| Variable | Description | Default |
| -- | -- | -- |
| __PORT__ | HTTP service listen port | 6789 |
| __ADDRESS__ | HTTP service listen address | 127.0.0.1 |
| __MODE__ | Service mode, can be `release` or `debug` | release |

### Development:

* Launch tests:
```
$ make test
```

* Launch service for tests development:
```
$ make test ARGS="follow"
$ PORT=7777 pytest -sv
```

* Generate build:
```
$ make
```

### License:
> GPL (GNU General Public License) 3.0

More info: [here](LICENSE)

### About
This service was created by: __@codexlynx__.

* Twitter: [https://twitter.com/codexlynx](https://twitter.com/codexlynx)
* GitHub: [https://github.com/codexlynx](https://github.com/codexlynx)