Skip to main content

Bootstrap and accelerate Arm Linux development with Topo

Discover container-based projects which unlock the potential of your Arm device. Configure them for your use case. Deploy and iterate over SSH.

Topo deployment and development loopTopo deployment and development loop

Getting started

Install and deploy with Topo

Install Topo and deploy your first project.

Install Topo

Project specification

Author your own Topo Projects

Add Topo metadata to a standard Compose project to enable hardware compatibility matching and configuration.

Read the specification

Development

Contribute to Topo

Work on Topo itself and follow the contributor workflow.

Open the guide

Topo workflow

Get your project running in seconds

Check device features and health, find compatible projects, and deploy over SSH without replacing your existing container workflow.

Check

Know the target is ready.

Verify the host, SSH connection, target, and hardware before deploying.

topo health --target user@target.example
Discover

Find projects that fit.

Match projects to the capabilities available on the target device.

topo projects --target user@target.example
Configure

Prepare the project.

Copy and configure a project on the host.

topo clone https://github.com/Arm-Examples/topo-welcome.git
Deploy

Ship over SSH.

Configure, build, transfer, and start the Compose project on the target.

topo deploy --target user@target.example