# Concelier Ubuntu USN Connector - Operations Runbook

_Last updated: 2026-01-16_

## 1. Overview
The Ubuntu connector ingests Ubuntu Security Notices (USN) and maps advisories to Ubuntu package versions.

## 2. Authentication
- No authentication required for public feeds.

## 3. Configuration (`concelier.yaml`)
```yaml
concelier:
  sources:
    ubuntu:
      baseUri: "<ubuntu-usn-base>"
      maxDocumentsPerFetch: 20
      fetchTimeout: "00:00:45"
      requestDelay: "00:00:00"
```

## 4. Offline and air-gapped deployments
- Mirror USN feeds into the Offline Kit and repoint `baseUri` to the mirror.

## 5. Common failure modes
- USN schema updates or missing release references.