Documentation

Astrari Docs

Everything you need to set up, configure, and get the most out of Astrari.

Monitor a website

→

Add any URL and start scanning externally — no agent, no DNS records, no plugin. SSL, headers, blacklists, email security, exposed files, and full WordPress CVE coverage.

SitesWordPressExternal

Install the server agent

→

Step-by-step guide to installing the Astrari agent on Linux servers. Covers requirements, the one-line install command, what gets installed, and how to verify everything is running.

AgentLinuxsystemd

Exposure probes

→

Active probes that catch what file-based scanners miss — services bound to the wrong interface, unauthenticated Redis/Memcached, exposed .git or .env files, weak TLS on running services, default-path admin panels. Plus how to whitelist probes in your WAF and how to write custom rules.

AgentNetworkTLSWAF

Log signals

→

The agent reads the security logs already on the host — sshd, sudo, lfd, fail2ban, firewall drops, maldet, root's mailbox — and ships hourly counters, never log lines. Ten rules catch a blocker that has stopped blocking, stale signatures, a failed control, a log gone silent. Includes the Prometheus /metrics endpoint.

AgentLinuxLogsPrometheus

Log review (ISO 27001)

→

Evidence for ISO 27001 A.8.15 and A.8.16 on the servers you opt in: a review queue of security-log events, Expected / Investigating / Escalated decisions, a weekly sign-off and a PDF + CSV evidence pack. Append-only, kept 13 months, no raw log lines.

AgentLogsISO 27001Evidence

Compliance evidence (ISO 27001)

→

Annex A controls and your own checklist, append-only evidence with a manifest hash, named sign-off with separation of duties, a weekly posture record, and expiring auditor links with a verifiable export pack.

ISO 27001EvidenceAuditAdd-on

Hardware health

→

On physical servers, the agent reads the server's own hardware sensors every 15 minutes — power supplies, fans, temperatures, memory errors, RAID arrays and disks — and reports faults as Hardware findings. Virtual machines are detected and skipped automatically.

AgentServersHardwareRAID

Intrusion detection

→

Optional CrowdSec with an nftables firewall bouncer. Starts in Monitor, showing what would have been blocked; Protect applies time-limited bans with a safety cap and allowlists, and defers to fail2ban, LFD or cPHulk where they already cover a service.

AgentServersIntrusionFirewall

How the security score works

→

The whole method behind the 0–100 number: severity weights, one bucket per package with the kernel family collapsed, diminishing returns, the 40% discount for CVEs nobody can patch in place, the separate hosted-sites layer that caps a server rather than zeroing it, and the hard floor for compromised systems.

ScoreCVEServersSites

FAQ

→

Answers to common questions about how Astrari works — the scanners, WordPress site checks, finding management, SSH auto-fix, forensic diagnostics, alert routing, the Cloudflare edge integration, support, billing, and more.

GeneralScannersDiagnosticsAlertsCloudflareSupportWordPressBilling

Changelog

→

Notable releases, improvements, and security-relevant changes. We ship continuously — this is the human-readable record of what's new and what's changed.

ReleasesImprovementsSecurity

API reference

→

REST endpoints for sites, servers, findings, reports, and outbound webhooks. Includes the HMAC signing scheme for verifying webhook deliveries. Available on Professional and Agency plans.

APIWebhooksIntegrations

Quick reference

Agent binary/usr/local/bin/astrari-agent
Config file/etc/astrari/agent.conf
State / data dir/var/lib/astrari/
Servicesystemctl status astrari-agent.service
Timersystemctl status astrari-agent.timer
Logsjournalctl -u astrari-agent -f
Versionastrari-agent --version
Installcurl -fsSL https://astrari.io/install.sh | bash
Uninstallcurl -fsSL https://astrari.io/uninstall.sh | bash

What Astrari monitors

Linux servers (agent-based)

  • ✓ Trivy — OS package CVE scanning
  • ✓ Vendor errata feeds (where enabled) — AlmaLinux, Rocky Linux, Red Hat, Ubuntu, Debian and Amazon Linux advisories matched against each server's package list, dated when the vendor publishes
  • ✓ ClamAV — malware and virus detection
  • ✓ rkhunter — rootkit and backdoor detection
  • ✓ MalDet — web shell and PHP malware
  • ✓ SSH hardening checks + auto-fix
  • ✓ Firewall and network security checks
  • ✓ Log signals — nine checks that catch a security control which has silently stopped
  • ✓ Log review — ISO 27001 review queue, weekly sign-off and evidence pack
  • ✓ File integrity monitoring
  • ✓ SSL certificate expiry
  • ✓ OS package update tracking and patching, with service packages (database, web server, PHP, mail server, containers) held back by default
  • ✓ Score trend (0–100) with scan history

Websites (agentless — works on any hosting)

  • ✓ Uptime monitoring — 1-minute probes, alerts on 2 consecutive failures
  • ✓ Content / defacement monitoring — 6-hourly content fingerprint with side-by-side diff
  • ✓ TLS deep audit — protocols, weak keys, signature algorithms, HSTS posture (CF / LE aware)
  • ✓ JavaScript supply-chain detection (Magecart class)
  • ✓ WordPress plugin / theme / core CVE matching
  • ✓ Outdated components with fix versions
  • ✓ Security headers (HSTS, CSP, X-Frame-Options…)
  • ✓ Cookie security flags (HttpOnly, Secure, SameSite)
  • ✓ SSL certificate and domain expiry
  • ✓ SPF and DMARC email security
  • ✓ Exposed file detection (wp-config.php, debug.log…)
  • ✓ User enumeration and directory listing
  • ✓ SEO spam, cloaking, and hidden link detection
  • ✓ Database scan for injected malware (agent-assisted, WordPress only)
  • ✓ .htaccess auto-fix for common hardening issues (agent-assisted, WordPress only)

Something missing? Let us know.