Skip to content
Portrait
Home Documentation Roadmap About

Documentation

Operator-facing guides for running Portrait. These describe the mechanism the platform gives you - they do not prescribe how your organization should use it.

This documentation tracks a moving target. Portrait is in active development toward a public beta. Where a page describes something as “not yet built”, that is accurate as written; the roadmap has the current picture.

Getting started

How Portrait works

Components, data flow, and the agent message exchange.

Installing the server

Placeholder The production install procedure is still being written.

Enrolling Windows hosts

The agent MSI, hostname-only registration, and the pending-approval hold zone.

Day-to-day administration

Roles & permissions

The RBAC model, the permission catalog, and the self-escalation guard.

Patching & profiles

Upgrade, package and reboot profiles; maintenance windows; how Portrait governs content it does not host.

Running scripts

The script library, ad-hoc versus scheduled runs, SYSTEM-only execution, and the audit trail.

Monitoring & alerts

Alert rules, notification sinks, and SIEM export.

Backup & restore

What backs up, the restore drill, and restoring over production.

For integrators

API reference

Placeholder The REST API, its auth model, and the generated OpenAPI schema.

Public beta · milestone M5

Portrait

AGPL-3.0 · © 2026 Eli Sowash

Portrait is an independent implementation, built from public documentation and observed behavior. It is not affiliated with, endorsed by, or derived from Canonical Ltd. “Landscape” and “Ubuntu” are trademarks of Canonical Ltd.