OpenFrame Gen1 is Here · Our AI platform for autonomous IT is out of beta.

Knowledge Hub

Comprehensive guides and references for the OpenFrame platform

Prerequisites

Before installing and using the OpenFrame CLI, ensure your environment meets the following requirements. The CLI can automatically check and install most prerequisites on macOS and Linux — on Windows, you will be guided to the relevant documentation.

System Requirements

Resource	Minimum	Recommended
RAM	24 GB	32 GB
CPU Cores	6 cores	12 cores
Disk Space	50 GB free	100 GB free
Operating System	macOS, Linux, Windows (WSL2)	macOS or Linux

Windows users: The OpenFrame CLI runs natively on Windows but automatically forwards all operations into WSL2 (Windows Subsystem for Linux). You must have WSL2 installed and a Linux distro configured. The CLI will auto-install itself inside WSL when first run.

Required Software

Tool	Minimum Version	Purpose	Auto-Installed?
Docker	24.x or newer	Container runtime for K3D clusters	✅ macOS/Linux
k3d	5.x or newer	Lightweight K3D cluster manager	✅ macOS/Linux
Helm	3.x or newer	Kubernetes package manager	✅ macOS/Linux
kubectl	1.28+	Kubernetes CLI (optional — CLI uses client-go directly)	❌ Manual
WSL2 (Windows only)	Windows 10/11	Linux environment on Windows	❌ Manual

Note: Docker, k3d, and Helm can be installed automatically by running openframe prerequisites install. On Windows, the CLI will display documentation links for each missing tool.

Operating System Details

macOS

macOS 12 (Monterey) or newer recommended
Docker Desktop for Mac or OrbStack required
Homebrew is recommended for manual tool management

Linux

Ubuntu 20.04+, Debian 11+, Fedora 36+, or any modern distribution
Docker Engine (not just the CLI) must be running
User must be in the docker group or have sudo access

Windows (via WSL2)

Windows 10 version 2004+ or Windows 11
WSL2 enabled: run wsl --install in PowerShell as Administrator
A Linux distro installed (Ubuntu recommended): wsl --install -d Ubuntu
Docker Desktop for Windows with WSL2 backend enabled

Account & Access Requirements

Requirement	Details
GitHub Access	Required for downloading the `openframe-oss-tenant` chart and for self-updates
GitHub Token (optional)	Set `OPENFRAME_GITHUB_TOKEN` or `GITHUB_TOKEN` to avoid rate limiting
Internet Access	Required for downloading charts, container images, and updates

Environment Variables

The following environment variables are recognized by the CLI:

Variable	Required	Description
`OPENFRAME_GITHUB_TOKEN`	Optional	GitHub personal access token (avoids API rate limits)
`GITHUB_TOKEN`	Optional	Standard GitHub token (also accepted)
`OPENFRAME_WSL_DISTRO`	Windows only	Target WSL distro name (default: WSL default distro)
`OPENFRAME_NO_WSL_FORWARD`	Windows only	Disable WSL forwarding (unsupported; use at your own risk)
`OPENFRAME_UPDATE_INSECURE_SKIP_VERIFY`	Emergency only	Skip cosign signature verification during updates
`KUBECONFIG`	Optional	Path to kubeconfig file (default: `~/.kube/config`)

Verification Commands

Run these commands to verify your environment is ready before installing OpenFrame CLI:

Check Docker

docker --version
docker ps

Expected output: Docker version and an empty container list (confirms Docker is running).

Check k3d

k3d version

Expected output: k3d version vX.Y.Z

Check Helm

helm version

Expected output: version.BuildInfo{Version:"vX.Y.Z", ...}

Check available memory

# macOS
sysctl -n hw.memsize | awk '{print $1/1024/1024/1024 " GB"}'

# Linux
free -h

Ensure at least 24 GB RAM is available.

Check disk space

df -h .

Ensure at least 50 GB free on the relevant partition.

Run CLI prerequisite check (after installing OpenFrame CLI)

openframe prerequisites check

This is the most comprehensive check — the CLI will display exactly what is missing and how to fix it.

Windows-Specific Setup

Expand Windows WSL2 Setup Steps

Step 1: Enable WSL2

Open PowerShell as Administrator and run:

wsl --install

Step 2: Install Ubuntu distro

wsl --install -d Ubuntu

Step 3: Install Docker Desktop

Download and install Docker Desktop for Windows. In Docker Desktop settings, enable:

WSL2 backend (Settings → General → Use WSL2 based engine)
Ubuntu integration (Settings → Resources → WSL Integration → Ubuntu)

Step 4: Set WSL2 as default (if needed)

wsl --set-default-version 2
wsl --set-default Ubuntu

Step 5: Download the Windows CLI binary

Download from: https://github.com/flamingo-stack/openframe-cli/releases/latest/download/openframe-cli_windows_amd64.zip

Extract and run the .exe — the CLI will automatically forward into WSL2.

Next Steps

Proceed to the Quick Start Guide to install and run OpenFrame CLI
Return to the Introduction for a feature overview

Frequently Asked Questions

About OpenFrame

What's included in OpenFrame? Does it integrate with my existing tools?

OpenFrame isn't built to plug into your stack. It replaces it. Instead of duct-taping a dozen tools together (RMM, MDM, SIEM, patching, remote access, each its own login and bill), we bundle it into one unified platform: RMM, MDM, monitoring, automation, remote access, patch management, security monitoring, and ticketing, plus built-in AI copilots. So "does it integrate with X?" usually means: you won't need X anymore.

How is OpenFrame different from other vendors?

Most platforms give you one piece and expect you to bolt the rest on. OpenFrame unifies the whole stack in one place, with AI copilots built in. Fewer logins, fewer bills, less duct tape.

Where is my data hosted?

In the cloud, on US soil. Your data stays stateside.

Is OpenFrame for MSPs or MSSPs?

Both. It's built for MSPs and MSSPs alike.

MSP AI Agents

Can AI Agents Really Close Tickets Without a Technician?

Yes. In production MSP shops today, 10% to 25% of tickets close before a human opens them. Thread alone has processed 173 million tickets across 750-plus MSP partners at 96% triage accuracy, handing back 490,000-plus technician hours. Agents own the low-risk, high-volume work (password resets, MFA enrollment, known installs, onboarding and offboarding) and flag anything that touches production data or needs judgment for a human to take.

How Much Can AI Agents Save an MSP?

On a five-person desk, reported deployments show $78,000 to $130,000 in annual direct labor savings, roughly 30% fewer escalations, and 15% to 20% better SLA compliance. Broader MSP adoption data adds ticket handling time cut by 45% and five to 12 points of margin, all from reclaimed capacity rather than headcount cuts.

Prerequisites

System Requirements

Resource	Minimum	Recommended
RAM	24 GB	32 GB
CPU Cores	6 cores	12 cores
Disk Space	50 GB free	100 GB free
Operating System	macOS, Linux, Windows (WSL2)	macOS or Linux

Windows users: The OpenFrame CLI runs natively on Windows but automatically forwards all operations into WSL2 (Windows Subsystem for Linux). You must have WSL2 installed and a Linux distro configured. The CLI will auto-install itself inside WSL when first run.

Required Software

Tool	Minimum Version	Purpose	Auto-Installed?
Docker	24.x or newer	Container runtime for K3D clusters	✅ macOS/Linux
k3d	5.x or newer	Lightweight K3D cluster manager	✅ macOS/Linux
Helm	3.x or newer	Kubernetes package manager	✅ macOS/Linux
kubectl	1.28+	Kubernetes CLI (optional — CLI uses client-go directly)	❌ Manual
WSL2 (Windows only)	Windows 10/11	Linux environment on Windows	❌ Manual

Note: Docker, k3d, and Helm can be installed automatically by running openframe prerequisites install. On Windows, the CLI will display documentation links for each missing tool.

Operating System Details

macOS

macOS 12 (Monterey) or newer recommended
Docker Desktop for Mac or OrbStack required
Homebrew is recommended for manual tool management

Linux

Ubuntu 20.04+, Debian 11+, Fedora 36+, or any modern distribution
Docker Engine (not just the CLI) must be running
User must be in the docker group or have sudo access

Windows (via WSL2)

Windows 10 version 2004+ or Windows 11
WSL2 enabled: run wsl --install in PowerShell as Administrator
A Linux distro installed (Ubuntu recommended): wsl --install -d Ubuntu
Docker Desktop for Windows with WSL2 backend enabled

Account & Access Requirements

Requirement	Details
GitHub Access	Required for downloading the `openframe-oss-tenant` chart and for self-updates
GitHub Token (optional)	Set `OPENFRAME_GITHUB_TOKEN` or `GITHUB_TOKEN` to avoid rate limiting
Internet Access	Required for downloading charts, container images, and updates

Environment Variables

The following environment variables are recognized by the CLI:

Variable	Required	Description
`OPENFRAME_GITHUB_TOKEN`	Optional	GitHub personal access token (avoids API rate limits)
`GITHUB_TOKEN`	Optional	Standard GitHub token (also accepted)
`OPENFRAME_WSL_DISTRO`	Windows only	Target WSL distro name (default: WSL default distro)
`OPENFRAME_NO_WSL_FORWARD`	Windows only	Disable WSL forwarding (unsupported; use at your own risk)
`OPENFRAME_UPDATE_INSECURE_SKIP_VERIFY`	Emergency only	Skip cosign signature verification during updates
`KUBECONFIG`	Optional	Path to kubeconfig file (default: `~/.kube/config`)

Verification Commands

Run these commands to verify your environment is ready before installing OpenFrame CLI:

Check Docker

docker --version
docker ps

Expected output: Docker version and an empty container list (confirms Docker is running).

Check k3d

k3d version

Expected output: k3d version vX.Y.Z

Check Helm

helm version

Expected output: version.BuildInfo{Version:"vX.Y.Z", ...}

Check available memory

# macOS
sysctl -n hw.memsize | awk '{print $1/1024/1024/1024 " GB"}'

# Linux
free -h

Ensure at least 24 GB RAM is available.

Check disk space

df -h .

Ensure at least 50 GB free on the relevant partition.

Run CLI prerequisite check (after installing OpenFrame CLI)

openframe prerequisites check

This is the most comprehensive check — the CLI will display exactly what is missing and how to fix it.

Windows-Specific Setup

Expand Windows WSL2 Setup Steps

Step 1: Enable WSL2

Open PowerShell as Administrator and run:

wsl --install

Step 2: Install Ubuntu distro

wsl --install -d Ubuntu

Step 3: Install Docker Desktop

Download and install Docker Desktop for Windows. In Docker Desktop settings, enable:

WSL2 backend (Settings → General → Use WSL2 based engine)
Ubuntu integration (Settings → Resources → WSL Integration → Ubuntu)

Step 4: Set WSL2 as default (if needed)

wsl --set-default-version 2
wsl --set-default Ubuntu

Step 5: Download the Windows CLI binary

Download from: https://github.com/flamingo-stack/openframe-cli/releases/latest/download/openframe-cli_windows_amd64.zip

Extract and run the .exe — the CLI will automatically forward into WSL2.

Next Steps

Proceed to the Quick Start Guide to install and run OpenFrame CLI
Return to the Introduction for a feature overview

Knowledge Hub

Prerequisites

System Requirements

Required Software

Operating System Details

macOS

Linux

Windows (via WSL2)

Account & Access Requirements

Environment Variables

Verification Commands

Check Docker

Check k3d

Check Helm

Check available memory

Check disk space

Run CLI prerequisite check (after installing OpenFrame CLI)

Windows-Specific Setup

Next Steps

Frequently Asked Questions

About OpenFrame

What's included in OpenFrame? Does it integrate with my existing tools?

How is OpenFrame different from other vendors?

Where is my data hosted?

Is OpenFrame for MSPs or MSSPs?

MSP AI Agents

Can AI Agents Really Close Tickets Without a Technician?

How Much Can AI Agents Save an MSP?

Prerequisites

System Requirements

Required Software

Operating System Details

macOS

Linux

Windows (via WSL2)

Account & Access Requirements

Environment Variables

Verification Commands

Check Docker

Check k3d

Check Helm

Check available memory

Check disk space

Run CLI prerequisite check (after installing OpenFrame CLI)

Windows-Specific Setup

Next Steps

Ready to Break Free?