https://github.com/linuxdicaspro/alpack
Portable rust tool for Alpine containers using proot and bwrap
https://github.com/linuxdicaspro/alpack
alpine-linux bubblewrap bwrap proot rootfs sandbox
Last synced: 8 months ago
JSON representation
Portable rust tool for Alpine containers using proot and bwrap
- Host: GitHub
- URL: https://github.com/linuxdicaspro/alpack
- Owner: LinuxDicasPro
- License: mit
- Created: 2025-09-17T15:05:27.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-09-17T23:12:53.000Z (9 months ago)
- Last Synced: 2025-09-17T23:25:39.786Z (9 months ago)
- Topics: alpine-linux, bubblewrap, bwrap, proot, rootfs, sandbox
- Language: Rust
- Homepage:
- Size: 674 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: changelog
- License: LICENSE
Awesome Lists containing this project
README
ALPack - Alpine Linux SandBox Packager
**ALPack** is a **portable** tool written in **Rust** for creating and
managing **Alpine Linux rootfs**. It uses **proot** and **bubblewrap (bwrap)**
to provide **isolated environments** without requiring superuser privileges.
## ✨ Features
- 📦 Easily create and manage **portable Alpine rootfs**.
- ⚡ Fast and minimal Alpine Linux environment setup;
- 🧪 Safe sandboxing for testing or restricted systems;
- 📆 Command execution inside containers;
- 📁 Support for multiple rootfs directories and caches;
- 💪 Ideal for compiling static binaries using musl and Alpine's minimal toolchain.
- 🛠️ Work directly with **APKBUILDs**, simplifying the packaging process.
- 💼 Run anywhere without complex installation, thanks to its fully **portable design**.
- 🔒 Runs without root;
Lightweight, fast, and productivity-focused, ALPack bridges the gap between Alpine
Linux flexibility and secure isolated environments.
## 🚀 Usage
Creating an Alpine rootfs:
```bash
$ ALPack setup
```
Run an Alpine rootfs:
```bash
$ ALPack
# or
$ ALPack run
```
Running in an isolated environment with proot or bwrap:
```bash
$ ALPack config --use-proot
# or
$ ALPack config --use-bwrap
```
## 📦 Optional Installation
You can install AlpineBox manually:
```bash
$ wget https://github.com/LinuxDicasPro/ALPack/releases/download/Continuous/ALPack
$ chmod +x ./ALPack
$ sudo mv ./ALPack /usr/bin/ALPack
```
Required proot or bubblewrap packages.
## 🧪 Why AlpineBox for Static Binaries?
Alpine Linux uses the **musl libc** and provides toolchains that are
naturally geared toward **static compilation**. Combined with the
lightweight nature of AlpineBox:
* You can quickly set up isolated environments for building static binaries with `musl-gcc`;
* Perfect for creating portable binaries that run across different Linux systems;
* Avoids linking with host system libraries;
* Small footprint and fast setup, ideal for CI/CD pipelines and embedded builds.
---
## 📄 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.