🐳 Dev Container Templates

A collection of templates for VS Code Dev Containers, designed for quick development environment setup.

🚀 Usage

1. 📂 Open VS Code in your project folder
2. ⌨️ Press Ctrl+Shift+P and select "Dev Containers: Add Dev Container Configuration Files..."
3. 📋 Choose "Show All Definitions..."
4. 🔍 In the search field, enter: ghcr.io/zyrakq/arch-devcontainer-templates/arch-base or ghcr.io/zyrakq/arch-devcontainer-templates/arch-webtop
5. ✅ Select the desired template from the list

🐳 Pre-built Images

These templates use pre-built Docker images for faster container startup and consistent environments.

Available Image Repositories

• zyrakq/arch-devcontainer-images - Pre-built Arch Linux images with various tools and desktop environments (used by default)
• bartventer/devcontainer-images - Comprehensive collection of Dev Container images with Arch Linux support

Both repositories provide daily-built images with the latest packages and security updates.

Why Pre-built Images?

• ⚡ Faster startup - No need to build images from scratch
• ✅ Tested - All images pass automated tests before publishing
• 🎯 Specialized - Choose images with exactly the tools you need

You can easily switch between images by editing the image field in .devcontainer/devcontainer.json.

📦 Available Templates

🏗️ arch-base

Base template using pre-built Arch Linux images with:

• 🐳 Pre-built image with common development tools
• 🚀 Fast container startup (no build required)
• 💾 Separate volumes for home directory and workspace
• 🔒 Custom network isolation
• 🔧 Multiple variants available (base, languages, Docker support)

🖥️ arch-webtop

Desktop template using pre-built Arch Linux desktop images with:

• 🐳 Pre-built images with desktop environments
• 🌐 Web-based GUI access via browser (port 3000)
• 🖥️ 5 desktop environments: KDE, i3, MATE, XFCE, or terminal-only (kasmvnc)
• 🚀 Fast container startup with pre-configured desktop
• 👤 User abc with HOME at /config
• 🔧 PUID/PGID support for proper file permissions

⚡ Available Features

Feature	Repository
🛠️ common-utils	ghcr.io/bartventer/arch-devcontainer-features/common-utils
☁️ aws-cli	ghcr.io/bartventer/arch-devcontainer-features/aws-cli
🔵 azure-cli	ghcr.io/bartventer/arch-devcontainer-features/azure-cli
🌐 gcloud-cli	ghcr.io/bartventer/arch-devcontainer-features/gcloud-cli
🐹 go	ghcr.io/bartventer/arch-devcontainer-features/go
🏗️ terraform	ghcr.io/bartventer/arch-devcontainer-features/terraform
🐳 docker-in-docker	ghcr.io/bartventer/arch-devcontainer-features/docker-in-docker
🔗 docker-outside-of-docker	ghcr.io/bartventer/arch-devcontainer-features/docker-outside-of-docker
📦 yay	ghcr.io/zyrakq/arch-devcontainer-features/yay
🎨 chaotic-aur	ghcr.io/zyrakq/arch-devcontainer-features/chaotic-aur
📥 clone-repo	ghcr.io/zyrakq/arch-devcontainer-features/clone-repo
📦 node	ghcr.io/zyrakq/arch-devcontainer-features/node
🦀 rust	ghcr.io/zyrakq/arch-devcontainer-features/rust
🔷 dotnet	ghcr.io/zyrakq/arch-devcontainer-features/dotnet
🔷 dotnet-bin	ghcr.io/zyrakq/arch-devcontainer-features/dotnet-bin

⚙️ Template Parameters

When using the template, you'll be prompted to specify:

arch-base

• 📝 Project Name: Project name (used for container and network names)

arch-webtop

• 📝 Project Name: Project name (used for container and network names)
• 🏷️ Title: Title displayed in the web interface
• 🕐 Timezone: Timezone for the container (e.g., Europe/London, America/New_York)

Note: Desktop environment is now selected by changing the image in .devcontainer/devcontainer.json. See template README for available options.

📁 Template Structure

.devcontainer/
├── devcontainer.json           # Main configuration with features
└── Dockerfile                  # Arch Linux image with required packages

🧪 Local Testing

For developers working on these templates, you can test changes locally using Act.

⚡ Quick Testing

# Test all templates (via pull request workflow)
act pull_request

🔍 Detailed Testing

For comprehensive testing instructions, troubleshooting, and advanced usage, see TESTING.md.

This allows you to validate template builds and tests before pushing changes to the repository.

🔧 Setup

After creating the .devcontainer configuration:

1. 🔄 Run "Dev Containers: Reopen in Container"

🔗 Related Projects

DevContainer Features

• bartventer/arch-devcontainer-features - DevContainer features for Arch Linux by bartventer
• zyrakq/arch-devcontainer-features - Additional DevContainer features for Arch Linux

This project was inspired by and borrows concepts from the above repositories.

📄 License

This project is dual-licensed under:

• Apache License 2.0
• MIT License