Release management
Plan releases, move them across a release board, run deployments to environments, set approval workflows, and track release metrics on a calendar.
Self-hosted · Open source · Real-time
CS Tool is a self-hosted monitoring platform. A lightweight agent on each Ubuntu server streams performance metrics and security events over HTTPS to your own backend, which raises alerts and pushes everything to a live dashboard.
// How it works
The agent samples CPU, memory, disk and network, and reads SSH, sudo and UFW logs for security events. If the backend is unreachable it buffers offline and retries.
Batches arrive over HTTPS with a per-server API key. Keys are stored hashed, and each server gets its own.
TimescaleDB hypertables with continuous aggregates, retention and compression. The alert engine checks every sample as it lands.
Metrics, security events, alerts and server status stream to the dashboard over WebSockets. No refreshing.
// The dashboard
// The agent
A Node.js agent packaged as a .deb with a systemd service. It runs as an unprivileged user with CPU and memory caps and filesystem hardening.
# build & install the package
$ cd packaging && ./build-deb.sh
$ sudo dpkg -i ../dist/monitor-agent_1.0.0_all.deb
# set server_url and api_key
$ sudo nano /etc/monitor-agent/agent.yaml
$ sudo systemctl enable --now monitor-agent
$ journalctl -u monitor-agent -f
// Alerting
Every ingested sample is checked. Open alerts are de-duplicated per server and type, broadcast live, and auto-resolve when things recover. Thresholds are set with ALERT_* environment variables.
// Beyond monitoring
Plan releases, move them across a release board, run deployments to environments, set approval workflows, and track release metrics on a calendar.
Record monthly spend per project and service, then spot servers that are idle or offline but still billed.
Map applications to the servers that host them, and see how your infrastructure connects.
Admin, operator and viewer roles, per-product access, passkeys, and an audit log of admin and delivery actions.
Ask operational and delivery questions from inside the dashboard.
// Get started
CS Tool ships as two Docker images. One compose file starts them with TimescaleDB and a proxy that serves the dashboard, the API and agent traffic from a single address.
mkdir cs-tool && cd cs-tool
curl -fsSLO https://qulaxy.com/cs-tool/setup/docker-compose.yml
curl -fsSL -o .env https://qulaxy.com/cs-tool/setup/env.example.env. On Linux this generates the secrets, then set your own ADMIN_PASSWORD:sed -i "s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$(openssl rand -hex 16)|" .env
sed -i "s|^JWT_SECRET=.*|JWT_SECRET=$(openssl rand -hex 32)|" .env
sed -i "s|^TOKEN_ENC_KEY=.*|TOKEN_ENC_KEY=$(openssl rand -hex 32)|" .env
nano .env # set ADMIN_PASSWORDADMIN_EMAIL and ADMIN_PASSWORD. The first sign-in asks you to set up two-factor with an authenticator app.docker compose up -dhttp://localhost:8080http://localhost:8080/api/v1SITE_ADDRESS=monitor.example.comFor a domain with automatic HTTPS, set SITE_ADDRESS, PUBLIC_URL and WEBAUTHN_RP_ID to it and use ports 80 and 443. Update later with docker compose pull && docker compose up -d.
Loading… open docker-compose.ymlLoading… open env.examplecurl -fsSLO https://github.com/KasunRocz-Softwares/cs-tool/releases/latest/download/monitor-agent_latest_all.deb
sudo apt-get install -y ./monitor-agent_latest_all.deb/etc/monitor-agent/agent.yaml, set server_url to your CS Tool address (your PUBLIC_URL) and api_key to the key, then restart the agent and follow its logs.sudo nano /etc/monitor-agent/agent.yaml
sudo systemctl restart monitor-agent
journalctl -u monitor-agent -fTo update an agent, run the same two install commands again; your agent.yaml is kept. Every package is on the releases page with SHA-256 checksums.
# Build and run everything from the source
git clone https://github.com/KasunRocz-Softwares/cs-tool.git
cd cs-tool
docker compose up --build
# Or run the parts for development
docker run -d --name tsdb -p 5432:5432 \
-e POSTGRES_USER=monitor -e POSTGRES_PASSWORD=monitor -e POSTGRES_DB=monitoring \
timescale/timescaledb:2.17.2-pg16
cd backend && npm install && cp .env.example .env
npm run migrate && npm run start:dev # :4000
cd dashboard && npm install && npm run dev # :5173
# Build the agent package yourself
cd packaging && ./build-deb.sh # -> dist/monitor-agent_<version>_all.debKeep .env private. The admin password is reset to ADMIN_PASSWORD every time the API starts, so change it there. Set tls_verify: true on every agent once you use HTTPS.
ghcr.io/kasunrocz-softwares/cs-tool-apighcr.io/kasunrocz-softwares/cs-tool-dashboard