🐳 Docker RISC-V64 APT Repository

RISC-V64 Debian Trixie Docker 29.x

APT repository for Docker and container tools on RISC-V64 architecture. Built from upstream sources with native RISC-V64 compilation.

📦 Packages: 8 packages available (see below)
🏗️ Architecture: riscv64
📍 Repository: gounthar/docker-for-riscv64

🚀 Quick Installation

# Import the GPG key
curl -fsSL https://gounthar.github.io/docker-for-riscv64/docker-riscv64.gpg.key | \
  sudo gpg --dearmor -o /usr/share/keyrings/docker-riscv64.gpg

# Add repository with signed-by key
echo "deb [arch=riscv64 signed-by=/usr/share/keyrings/docker-riscv64.gpg] https://gounthar.github.io/docker-for-riscv64 trixie main" | \
  sudo tee /etc/apt/sources.list.d/docker-riscv64.list

# Update package list
sudo apt-get update

# Install docker.io
sudo apt-get install docker.io

# Add your user to docker group
sudo usermod -aG docker $USER

# Enable and start service
sudo systemctl enable --now docker

⚠️ Important: Log out and back in for group changes to take effect, then test with: docker run hello-world

📦 Available Packages

This repository provides a complete Docker ecosystem for RISC-V64:

Package	Description	Install Command
`docker.io`	Meta-package: Docker Engine, CLI, containerd, and runc Recommended for most users	`apt install docker.io`
`docker-cli`	Docker CLI only (for remote Docker hosts)	`apt install docker-cli`
`docker-compose-plugin`	Docker Compose v2 plugin (`docker compose`)	`apt install docker-compose-plugin`
`docker-buildx-plugin`	Docker Buildx plugin for multi-platform builds	`apt install docker-buildx-plugin`
`buildkit`	BuildKit daemon for advanced image builds	`apt install buildkit`
`containerd`	Container runtime Included in docker.io; standalone for Kubernetes	`apt install containerd`
`runc`	OCI container runtime Included in docker.io; standalone for custom setups	`apt install runc`
`cagent`	Container agent for Docker Desktop integration and cloud services	`apt install cagent`

🛠️ Full Stack Installation

Install the complete Docker toolchain:

sudo apt-get install docker.io docker-compose-plugin docker-buildx-plugin

📋 What's in docker.io

The docker.io meta-package bundles everything needed to run Docker:

dockerd - Docker Engine daemon
docker - Docker CLI
docker-proxy - Network proxy for container port mapping
containerd - Container runtime
runc - OCI runtime
containerd-shim-runc-v2 - Containerd shim

🔄 Updates

The repository is automatically updated when new Docker releases are published. Update your system regularly:

sudo apt-get update && sudo apt-get upgrade

💾 Alternative: Direct .deb Download

You can also download and install the .deb package directly from GitHub releases:

# Download latest release
wget https://github.com/gounthar/docker-for-riscv64/releases/latest/download/docker.io_VERSION_riscv64.deb

# Install
sudo dpkg -i docker.io_*.deb
sudo apt-get install -f

📖 Documentation

ℹ️ About

This is an unofficial build of Docker Engine specifically for RISC-V64 systems. Built natively on BananaPi F3 hardware from official moby releases.

Maintainer: Bruno Verachten (@gounthar)
License: Apache 2.0 (same as Docker/moby)