Getting started
A Servbyte account takes about a minute to set up. Every new workspace starts on a 14-day free trial of the Pro plan — no credit card required.
- Sign up. Create your account at servbyte.io/signup with an email and password.
- Confirm your email. We send a verification link so we know the address is yours. The trial clock only starts once you've confirmed.
- Create a workspace. A workspace is the container for your hosts, team members, alert rules, and integrations. Most companies keep one workspace; agencies typically create one workspace per client environment.
- Install the agent on your first host — see the Quickstart below.
Quickstart
Servbyte installs with a single command. On any supported Linux host, run:
curl -sL servbyte.io/install.sh | bash
The installer downloads the agent, registers your host with your workspace, and starts an unprivileged servbyte-agent systemd service. Shortly after installation you'll see your first health signal in the dashboard, including CPU, memory, disk, and network baselines.
From there, add more hosts by re-running the same command on each machine — they'll appear automatically grouped under your workspace.
Installing the agent
The Servbyte agent runs as an unprivileged systemd service and communicates outbound-only over HTTPS to api.servbyte.io. It does not open any inbound network ports and does not require ongoing root access after installation.
# install curl -sL servbyte.io/install.sh | bash # verify it's running systemctl status servbyte-agent
The service runs as the servbyte user with least-privilege access to the metrics it needs. Logs are available via journalctl -u servbyte-agent.
Supported environments
Operating systems
- Ubuntu 20.04, 22.04, 24.04
- Debian 11, 12
- RHEL / CentOS Stream 8, 9
- Rocky Linux 8, 9
- AlmaLinux 8, 9
- Fedora (current stable)
- Amazon Linux 2, 2023
Architectures
- x86_64 (amd64)
- ARM64 (aarch64)
VPS & cloud providers
- DigitalOcean
- Hetzner
- Vultr
- Linode / Akamai
- AWS EC2 & Lightsail
- Any Linux VPS with outbound HTTPS
Containers
Docker containers are supported — the agent reports container status, restarts, and resource usage automatically.
Kubernetes is not currently supported.
Configuration
Configuration lives at /etc/servbyte/agent.toml. Most teams never need to touch it, but you can tune the metric interval and label hosts to fit your environment.
# /etc/servbyte/agent.toml [host] name = "prod-api-01" tags = ["production", "api", "hetzner"] [metrics] interval = "10s" # 5s – 60s
After editing, reload the agent with systemctl restart servbyte-agent.
Monitoring overview
Each Servbyte agent reports a consistent set of infrastructure signals:
System metrics
- CPU — overall and per-core utilization
- Memory — used, available, swap
- Disk — capacity and inode usage per mount
- Disk I/O — read/write throughput and latency
- Load averages — 1, 5, 15 minute
- Network I/O — bytes and packets per interface
- Uptime
Service & process signals
- Service status — systemd unit health
- Top processes by CPU and memory
- Docker container status and restart counts
- Docker per-container CPU and memory
Collection intervals
- Hobby — every 5 minutes
- Pro — every 30 seconds
- Team — every 10 seconds
The dashboard gives you a per-host view with time-series charts and a fleet view that rolls every host in the workspace into one screen — grouped by tag so you can spot the one machine drifting from the pack.
AI incident diagnostics
When an incident opens, Servbyte drafts a plain-language summary that correlates the signals already collected by the agent: system metrics, service state, top process data, and recent deploy markers (if you've wired them in via webhook).
Each summary includes
- What happened, in one sentence
- When it started and how long it's been active
- Which hosts, services, or containers were affected
- Likely cause, ranked by supporting evidence
- Suggested next steps to investigate or mitigate
AI incident diagnostics are included on the Pro and Team plans. The Team plan adds deeper multi-host correlation across the fleet.
Data boundary: Servbyte analyzes infrastructure signals only — never your application code, user data, or file contents.
AI-generated insights are assistive and may be incomplete or incorrect. Review the available evidence and verify all actions before making production changes.
Alerts & integrations
Servbyte can deliver alerts to Slack, Discord, email, or any HTTPS webhook. Add integrations from Settings → Integrations in the dashboard, then attach them to alert rules with per-channel severity filtering.
- Set thresholds for CPU, memory, disk, and custom service checks.
- Define quiet hours per channel to avoid paging humans overnight for warnings.
- Route critical incidents to a paging channel and warnings to a lower-priority room.
# example webhook payload
{
"incident_id": "INC-2148",
"severity": "critical",
"host": "prod-api-01",
"summary": "Memory leak in nginx-proxy",
"opened_at": "2026-07-28T14:22:07Z"
}Understanding incidents
Servbyte opens an incident when a metric crosses a configured threshold or a detector flags an anomaly — for example, steady RSS growth on a long-lived process. Each incident collects the metrics, events, and recent deploys around the window it fired in.
On top of that context, Servbyte drafts an AI incident summary with clear possible causes, a suggested next step, and links to the raw signals it used.
Team & workspace setup
Invite teammates from Settings → Team. Each member gets an email invitation and joins the workspace with the role you assign.
Roles (RBAC)
- Owner — full access, billing, workspace deletion. One per workspace.
- Admin — manage hosts, alerts, integrations, and members.
- Member — view everything, acknowledge and resolve incidents, edit alert rules.
- Viewer — read-only access to dashboards and incidents.
Role-based access control is available on the Team plan. Hobby and Pro workspaces treat all members as admins.
Server groups
Group hosts by environment, client, or service (e.g. production, staging, client-acme). Groups scope both alert rules and dashboards, so a rule you create forproduction only fires on hosts tagged into that group.
Billing & account
Plan changes
- Upgrades take effect immediately and are prorated for the current billing period.
- Downgrades take effect at the start of the next billing cycle so you keep what you've paid for.
- Cancellation stops future billing; your workspace stays active until the end of the current period.
Payment
Payments are handled by a PCI DSS Level 1 certified payment provider. Card details are never stored on Servbyte servers.
Invoices
Invoices are emailed to the workspace Owner after each successful charge and are also available from Settings → Billing.
Data retention after cancellation
After you cancel, we retain your workspace data for 30 days so you can reactivate without losing history. After that window, metric history and incident records are permanently deleted.
Troubleshooting
Agent not connecting
- Check the service is running:
systemctl status servbyte-agent - Confirm outbound HTTPS to
api.servbyte.iois not blocked by a firewall. - Verify the enrollment token in
/etc/servbyte/agent.tomlmatches your workspace. - Read the agent logs:
journalctl -u servbyte-agent -f
systemctl status servbyte-agent journalctl -u servbyte-agent -f curl -v https://api.servbyte.io/healthz
Metrics look stale
Stale metrics usually mean the agent is running but can't reach the API. Follow the connectivity steps above. If the host itself is under heavy load, samples can also be delayed — check the agent's own CPU usage in top.
Alerts not firing
- Confirm the rule is enabled.
- Check the duration — a threshold must hold for the configured window before firing.
- Send a test event from Settings → Integrations to confirm the channel works.
- Review the rule's cooldown — recently fired rules stay quiet until the cooldown elapses.
Agent using too much CPU or memory
The agent is designed to be lightweight, but on small VPS instances you can reduce its footprint:
- Increase the collection
intervalinagent.toml. - Reduce the number of services under active check.
- Update to the latest agent — recent releases include performance fixes.
Uninstalling
You're always in control. To fully remove the agent from a host, run:
curl -sL servbyte.io/uninstall.sh | bash
The script stops the systemd service, removes the agent binary and /etc/servbyte, and deregisters the host from your workspace.
API reference
Coming soon
A read/write REST API for hosts, incidents, and alert rules is on the roadmap. If you have a specific use case, let us know via the contact page — it helps us prioritize.
FAQ
What data does the agent send back to Servbyte?
Do you support Windows?
Can I export my data?
What happens if Servbyte itself is unreachable?
Does the agent need root or open any ports?
servbyte user and communicates outbound-only over HTTPS. It does not open any inbound network ports.