Get AutoSD
Get AutoSD¶
AutoSD is freely available as pre-built images, sample manifests, and source code. Which artifact you need depends on your goal.
Download pre-built images¶
If you want to boot AutoSD immediately without building from source, download a pre-built nightly image:
- AutoSD 10 nightly images -- QEMU-ready disk images for x86_64 and aarch64, rebuilt nightly from the latest AutoSD packages.
Pre-built images use the naming convention
auto-osbuild-$target-$distro-$image_name-$mode.$arch.$file_type.
For example, auto-osbuild-qemu-autosd10-developer-regular.x86_64.qcow2
is a QEMU developer image for x86_64.
Boot a downloaded image with the air tool:
$ curl -o air \
"https://gitlab.com/CentOS/automotive/src/automotive-image-builder/-/raw/main/bin/air"
$ chmod +x air
$ ./air --nographics <downloaded-image>.qcow2
Login credentials: root / password
Important
Pre-built sample images are for evaluation and development only. Do not use sample images in production.
Get sample manifests¶
The documentation repository includes a demos/ directory with
sample Automotive Image Builder manifests covering common use
cases such as minimal images, container embedding, RPM packaging,
IPC configuration, and BlueChi orchestration.
$ git clone https://gitlab.com/CentOS/automotive/sig-docs.git
$ ls sig-docs/demos/
Use these manifests with Automotive Image Builder to produce your own disk images. See the Quick Start Guide for a guided walkthrough.
Install Automotive Image Builder¶
Automotive Image Builder (aib) is the tool that turns manifests
into bootable OS images. You can run it from a container or install
it natively:
- Containerized (recommended for getting started): Run Automotive Image Builder from a container
- Native installation: Install Automotive Image Builder
Source code repositories¶
All AutoSD source code is developed in public GitLab repositories under the CentOS Automotive SIG:
| Repository | Description |
|---|---|
| automotive-image-builder | The image build tool |
| sig-docs | This documentation and sample manifests |
| CentOS Automotive SIG | Parent group for all SIG repositories |
Next steps¶
- Quick Start Guide -- Build and run your first image in 15 minutes
- AutoSD sample images -- Full list of available pre-built images and naming conventions
- What is AutoSD? -- Learn about the platform and its relationship to RHIVOS