---
name: "ostree-admin-stateroot-init"
section: "1"
platform: "linux"
package: "ostree"
version: "2026.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ostree-admin-stateroot-init"
---

# ostree-admin-stateroot-init(1)

Initialize empty state for a given operating system

## NAME

ostree-admin-stateroot-init - Initialize empty state for a given operating system

## SYNOPSIS

**ostree admin stateroot-init** {STATEROOT}

## DESCRIPTION

Initializes an new stateroot (AKA "osname") for an operating system. Ensures that the core subdirectories of /var (/tmp, /lib, /run, and /lock) exist and initialize the given STATEROOT as OSTree stateroot. Each deployment location is comprised of a single shared var and a set of deployments (chroots).

## EXAMPLE

**$ ostree admin stateroot-init exampleos**

```
        ostree/deploy/exampleos initialized as OSTree stateroot
```