PixelArch OS
PixelArch OS: A Docker-Optimized Arch Linux Distribution
PixelArch OS is a lightweight and efficient Arch Linux distribution specifically designed for Docker environments. It offers a streamlined platform for developing, deploying, and managing containerized applications.
Key Features:
- Arch-Based: Built on the foundation of Arch Linux, known for its flexibility and extensive package selection.
- Docker-Optimized: Tailored for efficient Docker usage, allowing for seamless integration with your containerized workflows.
- Frequent Updates: Regularly receives security and performance updates, ensuring a secure and up-to-date environment.
- Package Management: Utilizes the powerful yay package manager alongside the traditional pacman, providing a flexible and efficient way to manage software packages.
- Minimal Footprint: Designed to be lightweight and resource-efficient, ideal for running in Docker containers.
Getting Started
Using Distrobox
Each level builds upon the last, adding more features and configurations:
- Level 1: Quartz - The base installation, like a blank canvas.
- Level 2: Amethyst - Essential tools (like
curl
,wget
,docker
, and more) and a few quality-of-life improvements. - Level 3: Topaz - Specialized software for development. Comes with
python
,nodejs
, andrust
preinstalled. - Level 4: Emerald - Remote shell and tunnel support (via
tmate
,rdp
orssh
), and a full Enlightenment Desktop preinstalled.
Image Size - 530mb
- Step 1. Setup the OS (
distrobox create -i lunamidori5/pixelarch:quartz -n PixelArch --root
) - Step 2. Enter the OS (
distrobox enter PixelArch --root
)
Image Size - 870mb
- Step 1. Setup the OS (
distrobox create -i lunamidori5/pixelarch:amethyst -n PixelArch --root
) - Step 2. Enter the OS (
distrobox enter PixelArch --root
)
Image Size - 1.15gb
- Step 1. Setup the OS (
distrobox create -i lunamidori5/pixelarch:topaz -n PixelArch --root
) - Step 2. Enter the OS (
distrobox enter PixelArch --root
)
Image Size - 3.5gb
- Step 1. Setup the OS (
distrobox create -i lunamidori5/pixelarch:emerald -n PixelArch --root
) - Step 2. Enter the OS (
distrobox enter PixelArch --root
)
Using Docker
1. Clone the Repository
git clone https://github.com/lunamidori5/Midori-AI-Cluster-OS.git
2. Navigate to the aiclusteros
Directory
cd Midori-AI-Cluster-OS/aiclusteros
3. Run the Image and Access the Shell
Using docker-compose
:
a. Edit the docker-compose.yaml
file:
Each level builds upon the last, adding more features and configurations:
- Level 1: Quartz - The base installation, like a blank canvas.
- Level 2: Amethyst - Essential tools (like
curl
,wget
,docker
, and more) and a few quality-of-life improvements. - Level 3: Topaz - Specialized software for development. Comes with
python
,nodejs
, andrust
preinstalled. - Level 4: Emerald - Remote shell and tunnel support (via
tmate
,rdp
orssh
), and a full Enlightenment Desktop preinstalled. (Better for Distrobox, docker it will not work)
Image Size - 530mb
services:
pixelarch-os:
image: lunamidori5/pixelarch:quartz
tty: true
restart: always
privileged: false
command: ["sleep", "infinity"]
Image Size - 870mb
services:
pixelarch-os:
image: lunamidori5/pixelarch:amethyst
tty: true
restart: always
privileged: true
command: ["sleep", "infinity"]
volumes:
- /var/run/docker.sock:/var/run/docker.sock
Image Size - 1.15gb
services:
pixelarch-os:
image: lunamidori5/pixelarch:topaz
tty: true
restart: always
privileged: true
command: ["sleep", "infinity"]
volumes:
- /var/run/docker.sock:/var/run/docker.sock
Image Size - 3.5gb
services:
pixelarch-os:
image: lunamidori5/pixelarch:emerald
tty: true
restart: always
privileged: true
command: ["sleep", "infinity"]
volumes:
- /var/run/docker.sock:/var/run/docker.sock
b. Start the container in detached mode:
docker compose up -d
c. Access the container shell:
docker exec -it aiclusteros-pixelarch-os-1 /bin/bash
Note: The container name might differ from pixelarch-os, check your Docker Compose output or docker ps -a
for the actual name.
Using docker run
: (Not Recommened)
Build the Docker Image
docker build -t pixelarch -f arch_dockerfile .
Run the docker bash shell
docker run -it pixelarch /bin/bash
Package Management
Use the yay
package manager to install and update software:
yay -Syu <package_name>
Example:
yay -Syu vim
This will install or update the vim
text editor.
Note:
- Replace
<package_name>
with the actual name of the package you want to install or update. - The
-Syu
flag performs a full system update, including package updates and dependencies.
Support and Assistance
If you encounter any issues or require further assistance, please feel free to reach out through the following channels:
- Midori AI Discord: https://discord.gg/xdgCx3VyHU
- Midori AI Email: Email Us