Getting Started with VersionOps: Complete Setup Guide

Introduction

VersionOps helps DevOps teams track software versions across their infrastructure, get CVE alerts, and receive smart update recommendations. This guide walks you through the complete setup process.

Step 1: Create Your Account

1. Go to app.versionops.com/register
2. Sign up with your email or use Google/GitHub SSO
3. Create your organization

Step 2: Generate a Service Token

Service tokens authenticate your agents with VersionOps:

1. Navigate to Settings → Service Tokens
2. Click Create Token
3. Give it a descriptive name (e.g., "Production Agents")
4. Copy the token — you'll need it for agent installation

Step 3: Install the VersionOps Agent

Quick Install (Recommended)

curl -sSL https://get.versionops.com | sudo bash -s -- \
  --token YOUR_SERVICE_TOKEN \
  --url https://api.versionops.com

Manual Installation

Download the binary for your architecture:

# For AMD64
wget https://github.com/versionops/agent/releases/latest/download/versionops-agent-linux-amd64.tar.gz

# For ARM64
wget https://github.com/versionops/agent/releases/latest/download/versionops-agent-linux-arm64.tar.gz

# Extract and install
tar -xzf versionops-agent-*.tar.gz
sudo mv versionops-agent /usr/local/bin/
sudo chmod +x /usr/local/bin/versionops-agent

Configure the Agent

Create the configuration file:

sudo mkdir -p /etc/versionops
sudo cat > /etc/versionops/agent.conf << EOF
{
  "backend_url": "https://api.versionops.com",
  "token": "YOUR_SERVICE_TOKEN",
  "interval": 300,
  "log_level": "INFO"
}
EOF

Start the Agent

# Using systemd
sudo systemctl enable versionops-agent
sudo systemctl start versionops-agent

# Check status
sudo systemctl status versionops-agent

Step 4: Verify Connection

After installation, your host should appear in the VersionOps dashboard within a few minutes. The agent automatically:

• Detects installed packages (apt, yum, dnf)
• Scans for common applications (nginx, postgres, redis, etc.)
• Reports version information to VersionOps

Step 5: Add Applications

While the agent auto-discovers many applications, you can also add custom applications:

1. Go to Applications in the dashboard
2. Click Add Application
3. Enter the application name and current version
4. Configure version source (Repology, GitHub, or manual)

What's Next?

• Set up notifications — Get alerts via Slack, email, or webhooks
• Configure CVE scanning — Enable vulnerability monitoring
• Create version policies — Define acceptable version ranges
• Invite team members — Collaborate with your team

Troubleshooting

Agent not connecting?

Check the agent logs:

sudo journalctl -u versionops-agent -f

Token issues?

Verify your token is active in Settings → Service Tokens.

---

Need help? Check our documentation or contact support.