https://github.com/armbian/sdk
Daily virtual machine images preloaded with a ready-to-use Armbian development environment for x86 and arm64 hosts. Ships in ISO and qcow2 formats with Docker, the Armbian build framework, and a browser-based code-server IDE with the Claude Code plugin pre-configured.
https://github.com/armbian/sdk
armbian claude-code code-server development-environment iso-image qcow2-image sdk virtual-image workspace
Last synced: 6 days ago
JSON representation
Daily virtual machine images preloaded with a ready-to-use Armbian development environment for x86 and arm64 hosts. Ships in ISO and qcow2 formats with Docker, the Armbian build framework, and a browser-based code-server IDE with the Claude Code plugin pre-configured.
- Host: GitHub
- URL: https://github.com/armbian/sdk
- Owner: armbian
- Created: 2023-12-29T15:31:49.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-10T06:17:37.000Z (12 days ago)
- Last Synced: 2026-05-10T08:41:28.377Z (12 days ago)
- Topics: armbian, claude-code, code-server, development-environment, iso-image, qcow2-image, sdk, virtual-image, workspace
- Language: Shell
- Homepage: https://www.armbian.com
- Size: 83 KB
- Stars: 16
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Purpose of This Repository
The **Armbian SDK** publishes ready-to-deploy generic **Armbian** images preloaded with the toolchain, source repositories, and dependencies needed to develop on the Armbian platform — drop one onto a cloud provider, **Proxmox**, or any **QEMU/KVM**-capable hypervisor and start building immediately.
Daily builds from this repository's [GitHub Action](.github/workflows/build-armbian-sdk.yml) target **`uefi-x86`** and **`uefi-arm64`** on **Ubuntu Noble** and **Debian Trixie** with the **`cloud`** kernel, published as raw `.img.xz` and `.img.qcow2`.
## Quick Start
Download a `.img.qcow2` from the [latest release](https://github.com/armbian/sdk/releases/latest) and boot it under any QEMU/KVM-capable hypervisor.
- **Default credentials:** `armbian` / `armbian` (configured in [userpatches/firstboot.conf](userpatches/firstboot.conf))
- **code-server** (browser-based VS Code) on port `8443`
- **Build framework** checked out at `~/workspace/build`
## What's Inside
- **Curated source tree** pre-cloned into the code-server workspace at `/armbian/code-server/config/workspace/` (linked at `~/workspace` for shell users): [build](https://github.com/armbian/build), [configng](https://github.com/armbian/configng), [documentation](https://github.com/armbian/documentation), [website](https://github.com/armbian/website), [imager](https://github.com/armbian/imager).
- **Build dependencies** pre-installed (`./compile.sh requirements` already ran in the rootfs) — the first build skips the apt phase.
- **[code-server](https://coder.com/docs/code-server)** installed on first boot via `armbian-config --api module_code-server install`, with the **Python** extension (`ms-python.python`) pre-installed and the **[Claude Code](https://docs.claude.com/en/docs/claude-code)** CLI available in the integrated terminal.
- **SSH ready out of the box**: maintainer's GitHub public keys baked into both `root` and the `armbian` user via Armbian's `PRESET_*_KEY` firstboot mechanism.
- **Asset manifest** at a stable URL for programmatic consumption: .
## How It's Built
The [GitHub Action](.github/workflows/build-armbian-sdk.yml) drives a `{board} × {release} × {extension}` matrix through the [armbian/build](https://github.com/armbian/build) composite action. Each cell runs the build chroot's [customize-image.sh](userpatches/customize-image.sh) (clones, build deps, key seeding) and stages [provisioning.sh](userpatches/overlay/provisioning.sh) for first boot (code-server install, extension provisioning, ownership handover). After the matrix completes, an aggregator job merges per-image manifests into a single `armbian-images.json` and promotes the release from pre-release to latest.
## Resources
- **[Armbian Documentation](https://docs.armbian.com/Developer-Guide_Overview/)** — Building, configuring, and customizing
- **[Armbian Build Framework](https://github.com/armbian/build)** — The framework this SDK targets
- **[Website](https://www.armbian.com)** — News, features, and board information
- **[Forums](https://forum.armbian.com)** — Community support and discussions