Automata Linux

Automata Linux is the public base-image release channel for atakit workloads. It provides minimal Confidential VM guest images with the portal, container runtime, attestation support, and verified root filesystem required by atakit deployments.

Current release: automata-linux:v0.2.3-debug

Release page:

https://github.com/automata-network/automata-linux/releases/tag/v0.2.3-debug

Hoodi base image ID:

0x4653d145a2d680c4cac60a3b23c6ddcd5f7150c8bb43155a36c0b53beaf9125e

What This Repository Contains

This repository is intentionally small. It hosts public release metadata and GitHub release assets for Automata Linux images. The release assets are pulled by the atakit CLI; the repository is not an atakit source tree and does not build or package the atakit CLI.

The base image does not expose SSH. Access a deployment through the workload's declared ports, atakit status commands, and cloud serial output when needed. If a workload exposes SSH, that SSH server belongs to the workload container, not to the base image.

Release Assets

The v0.2.3-debug release contains:

• automata-linux-v0.2.3-debug-all.atabi
• automata-linux-v0.2.3-debug-gcp.atabi
• automata-linux-v0.2.3-debug-aws.atabi
• automata-linux-v0.2.3-debug-azure.atabi
• automata-linux-v0.2.3-debug-qemu.atabi

This release includes the rootlessport upload splice fix. The kernel release string inside the guest remains 7.0.6-automata.

Supported platforms:

• gcp
• aws
• azure
• qemu

Install atakit

Install the public atakit CLI from automata-network/atakit:

git clone https://github.com/automata-network/atakit.git
cd atakit
cargo install --path crates/atakit-cli

Confirm it is available:

atakit --help

Configure The Image Repository

Add the public Automata Linux image repository to ~/.config/atakit/config.toml:

[image.repositories]
automata = { repo = "automata-network/automata-linux" }

Pull The Base Image

Pull the GCP archive:

atakit image pull automata-linux:v0.2.3-debug gcp

Pull multiple platform archives:

atakit image pull automata-linux:v0.2.3-debug gcp,aws,azure,qemu

List local images:

atakit image ls

Use With Workload Examples

The public workload examples are available at melynx/cvm-workload-examples:

[image.repositories]
automata = { repo = "automata-network/automata-linux" }

[workload.repositories]
examples = { type = "github", repo = "melynx/cvm-workload-examples" }

Pull an example workload and deploy it with this base image:

atakit workload pull fedora-oci:v0.0.13 --verify

atakit cloud deploy fedora-oci:v0.0.13 \
  --target <configured-target> \
  --image automata-linux:v0.2.3-debug \
  --name fedora-oci-demo \
  --yes

See the workload examples repository for complete deployment guides and per-example usage.

Published Measurement Profiles

The cloud target and confidential-computing type are selected by your atakit cloud configuration.

Platform	Variants
gcp-tdx	c3-standard-4, c3-standard-8, c3-standard-22, c3-standard-44
gcp-sev-snp	n2d-standard-2, n2d-standard-4, n2d-standard-8, n2d-standard-16
azure-tdx	Standard_DC2es_v6, Standard_DC4es_v6, Standard_DC8es_v6, Standard_DC16es_v6
azure-sev-snp	Standard_DC2as_v5, Standard_DC4as_v5, Standard_DC8as_v5, Standard_DC16as_v5

Cleanup

Destroying a workload deployment removes the VM and workload resources. The uploaded provider image is reusable and is not removed unless image cleanup is explicitly requested.