PixelArch OS

pixelarch-logo pixelarch-logo

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, and docker, alongside several quality-of-life enhancements.
  • Level 3: Topaz - Development focused; pre-configured with key development languages and tools, including python, nodejs, and rust.
  • Level 4: Emerald - Remote access and desktop environment; provides secure remote shell and tunnel capabilities (via tmate, rdp, or ssh).

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: