Arch Linux DevContainer Features

A collection of DevContainer features for Arch Linux, providing stable and reliable development container experiences.

🚀 Available Features

🔧 Pacman Mirror Configuration

Configures pacman mirrorlist for faster package downloads on Arch Linux and Arch Linux ARM with multiple mirror sources.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/pacman-mirror:1": {
            "mode": "builtin"
        }
    }
}

📦 Yay AUR Helper

Installs yay - a popular AUR helper for easy installation of packages from the Arch User Repository.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/yay:1": {
            "installPackages": "visual-studio-code-bin,discord"
        }
    }
}

🎨 Chaotic-AUR Repository

Configures Chaotic-AUR repository for fast installation of pre-built AUR packages without compilation.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/chaotic-aur:1": {
            "mirror": "auto",
            "installPackages": "visual-studio-code-bin,discord"
        }
    }
}

📁 Clone Repository

Automatically clones a Git repository into your devcontainer workspace during container creation.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/clone-repo:1": {
            "repoUrl": "https://github.com/user/repo.git",
            "targetDir": "/workspace/project"
        }
    }
}

🟢 Node.js and npm

Installs Node.js and npm with sudo-free configuration for Arch Linux DevContainers.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/node:1": {
            "nodeVersion": "lts",
            "globalPackages": "typescript,nodemon"
        }
    }
}

🚀 Bun Runtime

Installs Bun - fast all-in-one JavaScript runtime and toolkit for Arch Linux with smart fallback installation methods.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/bun:1": {
            "installMethod": "pacman",
            "globalPackages": "typescript,esbuild"
        }
    }
}

🦀 Rust and Cargo (Pre-compiled)

Installs Rust programming language and Cargo package manager from pre-compiled packages for fast installation (10-60 seconds). Includes clippy, rustfmt, rust-src, and rust-analyzer.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/rust:2": {
            "globalCrates": "cargo-watch,cargo-edit,cargo-audit"
        }
    }
}

Use this when: You need stable Rust with fast installation for standard development.

Note: clippy and rustfmt are always included and cannot be disabled.

🦀 Rust and Cargo (Rustup)

Installs Rust programming language, Cargo package manager, and development tools via rustup for Arch Linux. Provides beta/nightly toolchains and additional compilation targets.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/rust-bin:1": {
            "rustVersion": "stable",
            "rustupProfile": "minimal",
            "additionalTargets": "wasm32-unknown-unknown",
            "globalCrates": "cargo-watch,cargo-edit,cargo-audit"
        }
    }
}

Use this when: You need beta/nightly toolchains, multiple toolchain management, or additional compilation targets.

🟣 .NET SDK and Runtime

Installs .NET SDK, runtime, and development tools from official Arch Linux packages.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/dotnet:1": {
            "dotnetVersion": "8.0",
            "installEntityFramework": true,
            "installGlobalTools": "dotnet-format"
        }
    }
}

🟣 .NET SDK and Runtime (AUR)

Legacy feature that installs .NET SDK and runtime from AUR packages. ASP.NET Core Runtime is included automatically.

{
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/yay:1": {},
        "ghcr.io/zyrakq/arch-devcontainer-features/dotnet-bin:1": {
            "dotnetVersion": "latest"
        }
    }
}

🏗️ Architecture

Stable Dependency on bartventer/arch-devcontainer-features

This project uses a Git submodules architecture for stability:

arch-devcontainer-features/
├── src/                     # Our features
│   ├── yay/
│   ├── chaotic-aur/
│   ├── clone-repo/
│   ├── node/
│   ├── bun/
│   ├── rust/               # Rust and Cargo feature (pre-compiled)
│   ├── rust-bin/           # Rust and Cargo feature (rustup)
│   ├── dotnet/
│   └── dotnet-bin/
└── vendor/                  # Dependencies
    └── bartventer-features/ # Git submodule v1.24.5
        └── scripts/
            └── archlinux_util_setup.sh

Architecture Benefits

✅ Stability: Dependency version pinned to v1.24.5
✅ Reliability: Works without external service dependencies
✅ Controlled updates: Updates only after testing
✅ Offline capability: All necessary scripts available locally

🚀 Quick Start

🎯 Ready-to-use Solutions

For quick start, you can use:

🐳 Ready Images: bartventer/devcontainer-images - ready-to-use DevContainer images for Arch Linux that can be extended with these features
📋 Templates: zyrakq/arch-devcontainer-templates - DevContainer templates for Arch Linux that can be extended with these features

📄 Creating devcontainer.json

{
    "name": "Arch Linux DevContainer",
    "image": "ghcr.io/bartventer/devcontainer-images/base-archlinux:latest",
    "features": {
        "ghcr.io/zyrakq/arch-devcontainer-features/yay:1": {
            "installPackages": "git,vim,curl"
        },
        "ghcr.io/zyrakq/arch-devcontainer-features/node:1": {
            "nodeVersion": "lts",
            "globalPackages": "typescript,nodemon"
        },
        "ghcr.io/zyrakq/arch-devcontainer-features/rust-bin:1": {
            "rustVersion": "stable",
            "globalCrates": "cargo-watch,cargo-edit,cargo-audit"
        },
        "ghcr.io/zyrakq/arch-devcontainer-features/dotnet:1": {
            "dotnetVersion": "8.0",
            "installEntityFramework": true
        },
        "ghcr.io/zyrakq/arch-devcontainer-features/clone-repo:1": {
            "repoUrl": "https://github.com/your-org/your-project.git",
            "targetDir": "/workspace"
        }
    },
    "postCreateCommand": "node --version && npm --version && rustc --version && cargo --version && dotnet --version && echo 'DevContainer ready!'"
}

🔧 Development

Feature Dependencies

All features in this repository install after ghcr.io/bartventer/arch-devcontainer-features/common-utils to ensure proper installation order and use scripts from the vendored bartventer-features submodule.

Important Notes:

Features dynamically download scripts based on the current submodule commit hash
Script versions are only updated when the submodule is updated to a new commit/tag
Features will fallback to main branch if submodule commit is not found

Updating Dependencies (Submodule)

# Check current submodule version
git submodule status

# Check available versions
cd vendor/bartventer-features
git fetch --tags
git tag --sort=-version:refname | head -10

# Update to new version (recommended: use tags)
git checkout v1.25.0
cd ../..
git add vendor/bartventer-features
git commit -m "Update bartventer-features to v1.25.0"

# Verify the commit hash that will be used
git ls-tree HEAD vendor/bartventer-features

Script URL Generation

Features automatically generate URLs using the submodule commit hash:

# Current submodule commit
COMMIT=$(git ls-tree HEAD vendor/bartventer-features | awk '{print $3}')

# Generated URL
URL="https://raw.githubusercontent.com/bartventer/arch-devcontainer-features/${COMMIT}/scripts/archlinux_util_setup.sh"

Project Structure

├── .devcontainer/           # DevContainer configuration for development
├── src/                     # DevContainer features
│   ├── yay/                # Yay AUR helper feature
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   └── README.md
│   ├── chaotic-aur/        # Chaotic-AUR repository feature
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   ├── NOTES.md
│   │   └── README.md
│   ├── clone-repo/         # Clone repository feature
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   └── README.md
│   ├── node/               # Node.js and npm feature
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   ├── NOTES.md
│   │   └── README.md
│   ├── bun/                # Bun runtime feature
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   ├── NOTES.md
│   │   └── README.md
│   ├── rust/               # Rust and Cargo feature (pre-compiled)
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   ├── NOTES.md
│   │   ├── examples.md
│   │   └── README.md
│   ├── rust-bin/           # Rust and Cargo feature (rustup)
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   ├── NOTES.md
│   │   ├── examples.md
│   │   └── README.md
│   ├── dotnet/             # .NET SDK and runtime feature (official packages)
│   │   ├── devcontainer-feature.json
│   │   ├── install.sh
│   │   ├── NOTES.md
│   │   └── README.md
│   └── dotnet-bin/         # .NET SDK and runtime feature (AUR packages)
│       ├── devcontainer-feature.json
│       ├── install.sh
│       └── NOTES.md
├── vendor/                 # Git submodule dependencies
│   └── bartventer-features/
├── test/                   # Feature tests
└── README.md              # This file

📋 Compatibility

Supported Architectures

linux/amd64
linux/arm64

Supported Systems

Primary: Arch Linux
Secondary: Other Linux distributions (for clone-repo)

Requirements

Docker or Podman
Visual Studio Code with Dev Containers extension
Git (for cloning features)

🔄 CI/CD

GitHub Actions

The project includes automated processes:

Testing: Automated tests for all features
Publishing: Publication to GitHub Container Registry
Versioning: Semantic versioning
Documentation: Automatic documentation updates

Publication

Features are automatically published to:

ghcr.io/zyrakq/arch-devcontainer-features/pacman-mirror
ghcr.io/zyrakq/arch-devcontainer-features/yay
ghcr.io/zyrakq/arch-devcontainer-features/chaotic-aur
ghcr.io/zyrakq/arch-devcontainer-features/clone-repo
ghcr.io/zyrakq/arch-devcontainer-features/node
ghcr.io/zyrakq/arch-devcontainer-features/bun
ghcr.io/zyrakq/arch-devcontainer-features/rust
ghcr.io/zyrakq/arch-devcontainer-features/rust-bin
ghcr.io/zyrakq/arch-devcontainer-features/dotnet
ghcr.io/zyrakq/arch-devcontainer-features/dotnet-bin

📖 Documentation

Pacman Mirror Configuration - Pacman mirrorlist configuration
Yay AUR Helper - Detailed yay feature documentation
Chaotic-AUR Repository - Chaotic-AUR feature documentation
Clone Repository - Clone-repo feature documentation
Node.js and npm - Node.js feature documentation
Bun Runtime - Bun runtime feature documentation
Rust and Cargo (pre-compiled) - Rust feature documentation (pre-compiled packages)
Rust and Cargo (rustup) - Rust feature documentation (rustup)
.NET SDK and Runtime - .NET feature documentation (official packages)
.NET SDK and Runtime (AUR) - .NET feature documentation (AUR packages)
DevContainers Specification - Official specification

🤝 Contributing

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Development Guidelines

All features should work on Arch Linux
Add tests for new features
Update documentation
Follow existing code style
Use semantic versioning

📄 License

This project is dual-licensed under:

🙏 Acknowledgments

This project uses code from:

bartventer/arch-devcontainer-features - Arch Linux utilities
devcontainers/features - Templates and examples

Thanks to the authors for their contributions to the DevContainers ecosystem!

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: DevContainers.dev

⭐ If this project was helpful, please give it a star!

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
.clinerules		.clinerules
.devcontainer		.devcontainer
.github		.github
.kilocode		.kilocode
.vscode		.vscode
src		src
test		test
vendor		vendor
.gitmessage		.gitmessage
.gitmodules		.gitmodules
LICENSE-APACHE		LICENSE-APACHE
LICENSE-MIT		LICENSE-MIT
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

Arch Linux DevContainer Features

🚀 Available Features

🔧 Pacman Mirror Configuration

📦 Yay AUR Helper

🎨 Chaotic-AUR Repository

📁 Clone Repository

🟢 Node.js and npm

🚀 Bun Runtime

🦀 Rust and Cargo (Pre-compiled)

🦀 Rust and Cargo (Rustup)

🟣 .NET SDK and Runtime

🟣 .NET SDK and Runtime (AUR)

🏗️ Architecture

Stable Dependency on bartventer/arch-devcontainer-features

Architecture Benefits

🚀 Quick Start

🎯 Ready-to-use Solutions

📄 Creating devcontainer.json

🔧 Development

Feature Dependencies

Updating Dependencies (Submodule)

Script URL Generation

Project Structure

📋 Compatibility

Supported Architectures

Supported Systems

Requirements

🔄 CI/CD

GitHub Actions

Publication

📖 Documentation

🤝 Contributing

Development Guidelines

📄 License

🙏 Acknowledgments

📞 Support

About

Topics

Resources

License

Licenses found

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages