Back to docs

Quick Start

Deploy Sentari and scan your first device in under 30 minutes.

Prerequisites

  • A Linux server with Docker (or a Kubernetes/OpenShift cluster) for the Sentari server
  • At least one device with software to scan (Python, npm, NuGet, Java, OS packages, or containers)
  • Network connectivity between agent and server (HTTPS, port 443)
  • A Sentari deployment bundle and license — provided when your pilot or license is issued

1. Deploy the Server

# Unpack the Sentari deployment bundle (provided with your pilot or license)
tar xzf sentari-deploy.tar.gz
cd sentari-deploy

# Start with Docker Compose
docker compose up -d

The self-contained bundle ships with its container images — no internet access required. The server starts on port 8000 with the dashboard at your server's address. Helm charts for Kubernetes/OpenShift are included for larger deployments.

2. Install the Agent

# Download the agent binary
curl -LO https://your-server/api/v1/agent/download

# Make executable and run
chmod +x sentari-agent
./sentari-agent --server https://your-server --enroll

The agent registers with the server, receives its mTLS certificate, and begins scanning automatically.

3. View Results

Open the dashboard in your browser. You'll see your device, its software environments, and all installed packages within minutes of the first scan.

Need help?

If you run into issues during setup, check our Architecture Overview for infrastructure requirements, or contact us for deployment support.