Releases: Adolfok3/comnix
Release list
1.0.0
comnix v1.0.0 — first release
Run remote SSH commands with a plain HTTP GET — straight from your homelab, no bloat.
comnix is a ~32 MB, Native AOT container that turns a GET /api/{route} request into a pre-configured SSH command against your homelab servers. No client library, no database, no auth handshake — just two JSON files and a container.
Highlights
- Route → SSH command mapping via
commands.json, with support for multiple named SSH connections (ssh.json) — password or private key auth. - Optional custom HTML response (
response.html) for a branded result page instead of raw JSON — great for phone home-screen shortcuts or bookmarklets. - Native AOT, self-contained, Alpine-based image — no SDK, no JIT, fast cold start.
- Config files are watched live — edit
commands.json/ssh.jsonand changes apply without restarting the container.
Getting started
```bash
docker run -d
--name comnix
-p 5000:5000
-v ./config:/app/config
adolfok3/comnix:1.0.0
```
See the README for the full configuration reference (ssh.json, commands.json, response.html) and Docker Compose example.
Security
comnix has no built-in authentication by design — it's meant to run only behind a trusted network boundary (LAN, VPN, or an authenticating reverse proxy). See ADR 0001 for the full reasoning and the README's Security section for deployment recommendations. Do not expose this container directly to the internet.
Docker image
adolfok3/comnix:1.0.0adolfok3/comnix:latest
Full Changelog: https://github.com/Adolfok3/comnix/commits/1.0.0