Signal.ge local agent is a background service for Linux, macOS, and Windows. It uses a project API Application key, sends host metrics and inventory, pulls assigned private monitoring checks, and can report local service health.
The agent brings host state into the dashboard, runs assigned checks from inside private networks, and reports selected local service health.
Reports CPU, memory, swap, load, uptime, process count, disk usage, and network counters to the project dashboard.
Can submit OS, kernel, architecture, CPU, hostname, and IP address inventory.
Pulls assigned HTTP, Ping, UDP, and DNS checks and returns the results through the API.
The services module checks MariaDB/MySQL, Redis, Nginx, Apache, PHP-FPM, and experimental MSSQL on Windows.
The config module accepts interval, disk path, and display name updates from the API and persists them in the env file.
The CLI manages API keys, features, services, and restarts; Windows also supports install/start/stop/uninstall service commands.
On Linux, add the Signal.ge package repository. On macOS and Windows, use the matching installer package. After installation, the API key is stored in the agent env file.
curl -fsSL https://repo.signal.ge/debian/signalge-agent-archive-keyring.asc | sudo gpg --dearmor --yes -o /usr/share/keyrings/signalge-agent-archive-keyring.gpg
echo 'deb [signed-by=/usr/share/keyrings/signalge-agent-archive-keyring.gpg] https://repo.signal.ge/debian stable main' | sudo tee /etc/apt/sources.list.d/signalge-agent.list
sudo apt update
sudo apt install signalge-agentsudo tee /etc/yum.repos.d/signalge-agent.repo >/dev/null <<'EOF'
[signalge-agent]
name=Signal.ge Agent
baseurl=https://repo.signal.ge/rpm/stable/$basearch
enabled=1
gpgcheck=0
metadata_expire=1h
EOF
sudo dnf install signalge-agentcurl -LO https://repo.signal.ge/macos/signalge-agent_1.3.1_darwin_arm64.pkg
sudo installer -pkg signalge-agent_1.3.1_darwin_arm64.pkg -target /curl -LO https://repo.signal.ge/macos/signalge-agent_1.3.1_darwin_amd64.pkg
sudo installer -pkg signalge-agent_1.3.1_darwin_amd64.pkg -target /Invoke-WebRequest -Uri https://repo.signal.ge/windows/signalge-agent_1.3.1_windows_amd64_setup.exe -OutFile signalge-agent-setup.exe
Start-Process .\signalge-agent-setup.exe -WaitInvoke-WebRequest -Uri https://repo.signal.ge/windows/signalge-agent_1.3.1_windows_386_setup.exe -OutFile signalge-agent-setup.exe
Start-Process .\signalge-agent-setup.exe -Waitsudo signalge-agent key set
sudo signalge-agent features set metrics,inventory,config,monitoring,services
sudo signalge-agent services set mysql,redis,nginx,apache,php
sudo signalge-agent restart
| Feature | Permission | Use |
|---|---|---|
| metrics | system.metrics.write |
Pipes CPU, RAM, storage paths, and health metrics data |
| inventory | system.inventory.write |
Ships OS metadata, environment architecture, and host specs |
| config | system.config.read |
Fetches runtime remote configurations dynamically from the central API |
| monitoring | system.monitoring.run |
Leases and returns localized private network monitoring checks |
| services | system.services.run |
Reports local service health-check results |
The Signal.ge Agent source code is publicly available on GitHub. Developers and system administrators can explore the project, install the agent across supported platforms, and contribute when needed.
The repository includes the agent source code, packaging files, installation scripts, and release information.
The lease allocation workflows, result pipelines, and metric ingestion endpoints are fully documented on our developer API layer page.
One workspace for a flexible control panel, developer-friendly API, global external checks, and local agents for monitoring infrastructure of any complexity.
