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.
PixelArch Flavors: A Tiered Approach
PixelArch is offered in a tiered structure, with each level building upon the previous, providing increasing functionality and customization options:
- Level 1: Quartz - The foundation; a minimal base system, providing a clean slate for your specific needs.
- Level 2: Amethyst - Core utilities; includes essential tools like
curl
,wget
, anddocker
, alongside several quality-of-life enhancements. - Level 3: Topaz - Development focused; pre-configured with key development languages and tools, including
python
,nodejs
, andrust
. - Level 4: Emerald - Remote access and desktop environment; provides secure remote shell and tunnel capabilities (via
tmate
,rdp
, orssh
).
Getting Started
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
)
1. Clone the Repository
git clone https://github.com/lunamidori5/Midori-AI-Cluster-OS.git
2. Navigate to the pixelarch_os
Directory
cd Midori-AI-Cluster-OS/pixelarch_os
3. Run the Image and Access the Shell
a. Edit the docker-compose.yaml
file:
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 pixelarch_os-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.
Midori AI recommends switching to Linux off of windows, if you still wish to use Pixelarch in WSL2 here is how, No support will be give to fix bugs on windows.
1. Setup the docker image
docker run -t --name wsl_export lunamidori5/pixelarch:quartz ls /
2. Export the pixelarch
os from docker
docker export wsl_export > /mnt/c/temp/pixelarch.tar
3. Clean up the docker iamge
docker rm wsl_export
4. Import Pixelarch into WSL
cd C:\temp
mkdir E:\wslDistroStorage\pixelarch
wsl --import Pixelarch E:\wslDistroStorage\pixelarch .\pixelarch.tar
1. Use Pixelarch shell
Image Size - 530mb
docker run -it --rm lunamidori5/pixelarch:quartz /bin/bash
Image Size - 870mb
docker run -it --rm lunamidori5/pixelarch:amethyst /bin/bash
Image Size - 1.15gb
docker run -it --rm lunamidori5/pixelarch:topaz /bin/bash
Image Size - 3.5gb
docker run -it --rm lunamidori5/pixelarch:emerald /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