{% extends "base.html" %} {% block title %}Settings{% endblock %} {% block heading %}Settings{% endblock %} {% block content %}

Caches

{% include "_cache_badges.html" %}

Security lookups are cached in the application database: NVD CVSS data per CVE (table nvd_cache), Canonical security data per CVE (cve_metadata_cache) and Amazon Linux updateinfo per repository (amazon_updateinfo_cache). An entry younger than its TTL is used without a request; an older one is refreshed on its next lookup and only used as a fallback when the source cannot be reached. Changing a TTL never deletes entries. Failed lookups are never cached.

{% for key, label in cache_ttl_labels.items() %}
{% if cache_ttl_errors.get(key) %}
{{ cache_ttl_errors[key] }}
{% endif %}
{% endfor %}
Hours (24h) or days (30d), between 1 hour and 365 days. Defaults: NVD 30d, Canonical 24h (1h while a release is under investigation), Amazon updateinfo 24h.{% if not cache_ttl_saved %} The defaults are in use.{% endif %}

Clear Security Cache empties these caches (NVD, Canonical and Amazon updateinfo), the stored OVAL, USN, KEV and EPSS data and the in-memory lookup state.

Run progress

{% if step_timeout_error %}
{{ step_timeout_error }}
{% endif %}
Between {{ step_timeout_min }} and {{ step_timeout_max }} seconds; default {{ step_timeout_default }}. In an analysis, a blocking call that takes longer (opening SSH, listing packages, one CVE lookup) fails that server and the run moves to the next one. When patching it only shortens the commands before the install; scp, the install and the reboot keep their own limits. Commands with a shorter limit of their own keep it.

Patch & Download Settings

{% if template_error %}
{{ template_error }}
{% endif %}
Must contain ${server_name} and resolve to an absolute path (~ is expanded). Default: {{ default_staging_template }}. Changes apply to future patch executions only.
Saved Template
{{ saved_template }}
Resolved for {{ preview_name }}
{% if preview %}{{ preview }}{% else %}{{ preview_error }}{% endif %}
Remote Staging
{{ remote_example }} (fixed: /tmp/${server_name} on the server)
{% if server_names|length > 1 %}
{% endif %}

Connection

How servers without their own connection type are reached. SSH over SSM runs the same ssh and scp through aws ssm start-session as ProxyCommand; it needs the AWS CLI on this machine and the Session Manager plugin, which can be installed from here without sudo. AWS credentials stay in the AWS CLI configuration; only the profile name is stored here.

{% from "_aws_dropdown.html" import aws_dropdown %} {% set aws = aws_profiles() %}
{% if connection_errors.connection_type %}
{{ connection_errors.connection_type }}
{% endif %}
{{ aws_dropdown("profile", "aws_profile", "default_aws_profile", aws_dropdown_view(connection_form.aws_profile, aws.profiles, "aws_profile" in (connection_form.other_chosen or [])), "None", 128, "example") }}
The list comes from your AWS CLI config.{% if aws.reason %} {{ aws.reason }} Use Other… to type a name.{% endif %}
{% if connection_errors.aws_profile %}
{{ connection_errors.aws_profile }}
{% endif %}
{{ aws_dropdown("region", "aws_region", "default_aws_region", aws_dropdown_view(connection_form.aws_region, aws_regions, "aws_region" in (connection_form.other_chosen or [])), "None", 32, "us-east-1", connection_form.region_from_profile) }}
Choosing a profile selects its region from the AWS CLI config, if it has one. Other… must look like us-east-1.
{% if connection_errors.aws_region %}
{{ connection_errors.aws_region }}
{% endif %}
Save changes the servers that follow the default. Apply to all servers also clears the connection type, AWS profile and region set on individual servers; manual instance IDs are kept.

SSH over SSM status

{% include "_ssm_status.html" %}
Check now {% if not ssm_plugin_location or ssm_plugin_location.managed %}
{% endif %}
Install SSM plugin downloads the official Ubuntu package from AWS, verifies it and keeps its program in {{ ssm_plugin_dir }}. No sudo; nothing else on this machine changes.

NVD API Key

Optional key for faster CVSS lookups (50 instead of 5 NVD requests per 30 s). A key saved here is stored encrypted and is used instead of the NVD_API_KEY environment variable. Only its last 4 characters are ever shown.

Saved key
{% if nvd_key.error %}{{ nvd_key.error }}{% elif nvd_key.saved %}{{ nvd_key.masked }}{% else %}none{% endif %}
NVD_API_KEY env var
{% if nvd_key.env_set %}set{% if nvd_key.saved %} (overridden by the saved key){% endif %}{% else %}not set{% endif %}
Status
{% include "_nvd_key_badge.html" %}
{# Never pre-filled: the key is never sent back to the browser. #} {% if nvd_key_error %}
{{ nvd_key_error }}
{% endif %}
{% if nvd_key.testable %}{% endif %} {% if nvd_key.saved %}{% endif %}

Logging

{% if log_dir_error %}
{{ log_dir_error }}
{% endif %}
Absolute path (~ is expanded); it is created if needed and must be writable. Default: {{ default_log_dir }}.
Current log file
{% if active_log_file %}{{ active_log_file }}{% else %}{{ log_file }} (file logging is not active in this process){% endif %}
Rotation
{{ log_backups }} × {{ log_max_mb }} MB (oldest file is removed)

Application

Version
{{ version }}
Database
{{ db_path }}
SSH user
Per server (default ubuntu)
SSH login
Per server: PEM key (default) or username + password via sshpass; passwords are stored per server, encrypted
Encryption key
{{ secret_key_path }} (mode 0600, never in the database; without it stored secrets must be entered again)

Security Data

Each CVE is resolved by the first source that answers: Canonical's OVAL feed, the USN notices, the package's changelog, then the per-CVE JSON below as a last resort. Sources are probed when a run starts and a blocked one is skipped for that run. Each CVE fetched from the per-CVE JSON is also cached in the application database (see Caches for the TTLs); an expired copy is used (and marked with its age) only when ubuntu.com cannot be reached.

Cache
table cve_metadata_cache in {{ metadata_status.cache_db }}
Cache TTL
{{ "%g"|format(metadata_status.cache_ttl_hours) }} hours ({{ "%g"|format(metadata_status.investigating_ttl_hours) }} hour{{ "" if metadata_status.investigating_ttl_hours == 1 else "s" }} while a release is under investigation) — change
Requests
{{ "%g"|format(metadata_status.timeout_seconds) }} s timeout, {{ "%g"|format(metadata_status.pace_seconds) }} s apart, up to {{ metadata_status.attempts }} attempts with backoff; lookups pause for the rest of the run after {{ metadata_status.breaker_threshold }} consecutive failures
Proxy
HTTPS_PROXY / HTTP_PROXY / NO_PROXY from the environment (also for .deb downloads)

APT Repositories

Mirrors of the Ubuntu archive this workstation reads for APT candidates and the .deb plan, e.g. an internal proxy mirror (Nexus) when Canonical's hosts are blocked. An empty field keeps the Ubuntu default shown in it. URLs must be http:// or https://, without credentials, query string, spaces or quotes; ${codename} (e.g. noble) is the only placeholder. Servers never use these mirrors: they only install the approved .deb files.{% if not apt_saved %} The Ubuntu defaults are in use.{% endif %}

{% for key in ("archive_mirror", "security_mirror", "ports_mirror", "keyring") %}
{% if apt_errors.get(key) %}
{{ apt_errors[key] }}
{% endif %}
{% endfor %}
Example: https://nexus.example.internal/repository/ubuntu-archive or https://nexus.example.internal/repository/ubuntu-${codename}. Archive and security serve amd64 and i386, ports every other architecture. A different keyring is only needed if the mirror re-signs the archive.
The changelog fallback of the CVE resolver (and its probe) reads Packages indexes and .debs from the security / ports mirror instead of security.ubuntu.com.

Opt-in fallbacks

A CVE without Canonical metadata that is linked to installed source packages (pasted list, OVAL of other releases, USNs) is checked against the mirror's candidates; a newer candidate is planned as {{ status_labels["CANDIDATE_WITHOUT_METADATA"] }}.
A CVE Canonical lists as pending publication with a version is planned as {{ status_labels["FIX_AVAILABLE_PENDING_PUBLICATION"] }} when the mirror's candidate reaches that version. Kernels are never planned this way. Both fallbacks are off by default, and patching such a plan always needs an explicit confirmation.
{{ apt_preview }}
{% if apt_checks %} {% for c in apt_checks %}{% endfor %}
PocketInReleaseResult
{{ c.suite }}{{ c.url }}{% if c.ok %}{{ c.detail }}{% else %}{{ c.detail }}{% endif %}
{% endif %}

APT Resolution

APT candidates and the .deb plan are resolved on this workstation against private package lists per Ubuntu release and architecture (release, -updates and -security pockets). Servers are only read (dpkg-query); the system APT configuration is never used or changed.

Private APT state
{{ apt_state_dir }}
Refresh when older than
{{ "%g"|format(apt_max_age_hours) }} hours{% if not apt_max_age_hours %} (every analysis run){% endif %}

Reset Database

Permanently removes servers, reports, analyses, and settings.

{% endblock %}