Get Started with Avocado OS and Peridio Core

The ecosystem

Fleet Management Made Easy

What isAvocado OS

A modern, secure, developer-friendly, immutable operating system — designed from the ground up for edge devices. Avocado OS is a production-grade embedded Linux distro built on the Yocto Project, but delivered as precompiled binaries. You get the most advanced, secure operating system built for the edge. Your hardware deserves a better OS.

Highlights

Immutable and signed
A read-only, signed root filesystem with atomic updates built in.
Composable, not a fork
A curated base plus whatever your product needs — not a forked vendor BSP.
Reproducible bit for bit
The same inputs produce the same image on your laptop, in CI, and on the line.
Apache-2.0, all of it
Inspect it, fork it, ship it. Long-term support is available per contract.

Everything about Avocado OS

Supported hardware & QEMU

Pick your board — the workflow is the same

Avocado OS is supported on 20+ targets across 5 silicon families, and because we deliver your OS down through our package feeds, you can build on your laptop — not a build machine. Switching hardware? It's a one line code change. Yes, it's that easy.

Read the getting-started guide

NVIDIA Jetson
Orin NX · Orin Nano · Jetson NX · Jetson AGX · Jetson AGX Thor
NXP i.MX
i.MX 8M Plus · i.MX 93 · i.MX 95
Raspberry Pi
Compute Module 4 · Compute Module 5
Synaptics
Grinn AstraSOM-1680
Renesas RZ
RZ/G2L · RZ/V2H

20+ supported targets

Production silicon from 5 families. Each target is built, signed, and provisioned through the same pipeline.

See the support matrix

No board yet?

Start on your laptop. When the dev kit arrives, point the build at it — nothing else about your setup moves.

01Boot the image under QEMU
02Swap in the dev kit
03Ship to the fleet

Start with the quickstart

Tooling & developer experience

Three ways to drive a build. Same Avocado OS underneath

A CLI, a desktop app, and agentic coding support. All are free and provide best in class developer experience.

01 · Build

Avocado CLI

Built for builds, automation, CI, and headless Linux. One command installs it, and the same binary drives init, install, build, and provision — so your local workflow and your pipelines stay in sync.

Install

Detects your platform, fetches the matching build, and puts avocado on your PATH. Covers macOS, Linux, and Windows.

$ curl -fsSL https://connect.peridio.com/install.sh | sh

View script source

Command line

One install command on macOS, Linux, and Windows
init, install, build, provision — one binary
The same commands locally and in CI
Headless-friendly, nothing to click through

See every CLI build and checksum

02 · Build

Avocado Desktop

A guided local workflow. A native app to run and manage Avocado on your own machine — project setup, builds, and flashing without memorising a command surface.

Native app

A bundled cross-compilation toolchain, with a build VM on macOS
Visual project setup, builds, and flashing
Hardware provisioning over USB and SD card
A developer-preview AI agent wired to the Avocado MCP

Download Avocado Desktop

macOS 13.0+ universal · Linux x86_64Windows soon

03 · Enable

MCP server

Agent-assisted development. Peridio ships an MCP server, so coding agents drive the platform directly — querying the package graph, editing the project, running builds, and provisioning hardware. It also knows Avocado Desktop and what that app can do, so a plain-language request becomes a real local action rather than a suggestion you carry out yourself.

Agent

ready

set up my Compute Module 5 with the USB camera and flash it
Agent
Let me see which project you're on and what target it's set to.
mcp__avocado-desktop__list_projectsSUCCESS
```
cm5-camera     rpi-cm5      not built
edge-gateway   imx8m-plus   built
```
mcp__avocado-desktop__list_targetsSUCCESS
Agent
cm5-camera is on the rpi-cm5 target. A UVC camera wants three packages — checking they are in the feed.
mcp__avocado-os__query-reposSUCCESS
```
uvc
v4l2
media-ctl
```
mcp__avocado-desktop__add_package_to_extensionSUCCESS
mcp__avocado-os__get-config-schemaSUCCESS
Agent
All three are in the dev extension and avocado.yaml still validates. Building, then I will flash it.
mcp__avocado-desktop__run_avocado_cliSUCCESS
```
$ avocado build
image ready · 11m 06s
```
mcp__avocado-desktop__run_project_actionFAILED
```
no device in mass-storage mode
```
Agent
The image is built, but provisioning cannot see the board. Hold BOOT while you replug it and I will pick this up.
replugged
mcp__avocado-desktop__list_devicesSUCCESS
mcp__avocado-desktop__run_project_actionSUCCESS
mcp__avocado-desktop__open_monitorSUCCESS
mcp__avocado-desktop__monitor_readSUCCESS
```
[  OK  ] Started Avocado runtime.
avocado login:
```
Agent
It boots, and /dev/video0 is there. The serial monitor is still open if you want to poke at it.

Agent integration

Describe a need in plain language
The agent resolves the packages against the live feed
Wires them into the runtime, builds, and flashes
“Rebuild and deploy the update locally” — it drives Avocado Desktop
“Debug over SSH why my app is not running”
Reads the serial console when a board will not boot

Set up the MCP server

Peridio Core · the cloud platform

Fleet Management Made Easy

Avocado OS is free and open source, empowering you to launch with a truly modern, secure operating system. You deserve an equally capable fleet management product for when your devices leave the lab. We built Peridio Core to provide an end-to-end platform for managing your devices, deploying OTAs, establishing secure remote tunnels, observability, and more.

OTA deployment

From the CLI or the console

Publish a signed release and roll it out by cohort. Atomic A/B updates with signed rollback, so a bad release is recoverable.

Observability

Device and fleet health

See which devices are on which version, what failed, and what is drifting — before a customer tells you.

Secure remote access

Tunnels, not open ports

Open a short-lived tunnel to a device behind NAT for debugging, without standing up your own bastion.

Fleet management

Prototype to production

The same control plane whether you have one dev kit on a desk or thousands of units in the field.

Or from the terminal

The console and the CLI are the same platform. Deploy from whichever fits your process — a release engineer in a browser, or a pipeline with no human in it.

Deploy

$ avocado connect deploy --cohort production

Create your free account

Proof and confidence

Teams already run their hardware on this

The operating system and the update path are the most tightly held parts of a hardware product. Here is who already trusts us with them.

“I've been looking for somebody like you guys since I joined about a year ago, to just own this.”

Head of Edge Engineering, AI/Computer Vision Platform

“It does solve a big problem that we were looking at that we were eventually going to have to build. All the solutions we were finding were overbuilt.”

CEO, Industrial Computer Vision Company

“You're doing this stuff that we were like, should we hire a bunch of people to do this? And we don't know what the hell we're doing. It's just amazing.”

CEO, AI Platform Company