---

name: docker-test description: Test voxtype in Docker containers. Use for testing builds, verifying packages work on different distros, or isolating test environments. user-invocable: true allowed-tools:

• Bash
• Read
• Glob

---

Docker Test

Test voxtype builds and packages in isolated Docker containers.

Build Testing

Build AVX2 Binary (Clean Toolchain)

Uses Ubuntu 22.04 to avoid AVX-512 instruction contamination:

Copy./scripts/build-docker.sh

Output: releases/${VERSION}/voxtype-${VERSION}-linux-x86_64-avx2

Build Vulkan Binary

Uses remote Docker context (pre-AVX-512 CPU) for clean build:

Copy./scripts/build-docker-vulkan.sh

Output: releases/${VERSION}/voxtype-${VERSION}-linux-x86_64-vulkan

Full Docker Compose Build

CopyVERSION=0.4.14 docker compose -f docker-compose.build.yml build --no-cache avx2 vulkan
VERSION=0.4.14 docker compose -f docker-compose.build.yml up avx2 vulkan

Package Testing

Test Debian Package

Copy# Build test container
docker run -it --rm -v $(pwd)/releases:/releases ubuntu:22.04 bash

# Inside container:
apt update && apt install -y /releases/0.4.14/voxtype_0.4.14-1_amd64.deb
voxtype --version
voxtype --help

Test RPM Package

Copy# Fedora
docker run -it --rm -v $(pwd)/releases:/releases fedora:latest bash

# Inside container:
dnf install -y /releases/0.4.14/voxtype-0.4.14-1.x86_64.rpm
voxtype --version

Distro-Specific Testing

Ubuntu/Debian

Copydocker run -it --rm ubuntu:22.04 bash -c "
  apt update &&
  apt install -y curl libasound2 &&
  curl -L https://github.com/peteonrails/voxtype/releases/download/v0.4.14/voxtype-0.4.14-linux-x86_64-avx2 -o /usr/bin/voxtype &&
  chmod +x /usr/bin/voxtype &&
  voxtype --version
"

Fedora

Copydocker run -it --rm fedora:latest bash -c "
  dnf install -y alsa-lib curl &&
  curl -L https://github.com/peteonrails/voxtype/releases/download/v0.4.14/voxtype-0.4.14-linux-x86_64-avx2 -o /usr/bin/voxtype &&
  chmod +x /usr/bin/voxtype &&
  voxtype --version
"

Arch Linux

Copydocker run -it --rm archlinux:latest bash -c "
  pacman -Sy --noconfirm base-devel git &&
  # Test AUR package build
  git clone https://aur.archlinux.org/voxtype-bin.git &&
  cd voxtype-bin &&
  makepkg -si --noconfirm
"

Docker Context Management

For builds requiring a pre-AVX-512 CPU:

Copy# List contexts
docker context ls

# Switch to remote build server
docker context use truenas

# Build clean binaries
docker compose -f docker-compose.build.yml up avx2 vulkan

# Switch back to local
docker context use default

Troubleshooting

Build cache issues:

Copydocker compose -f docker-compose.build.yml build --no-cache

Container won't start: Check if audio devices are needed - voxtype requires ALSA/PipeWire which may not be available in containers.

Version mismatch after build: Docker cached old layers. Always use --no-cache for release builds.