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.

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, and rust preinstalled.
  • Level 4: Emerald - Remote shell and tunnel support (via tmate, rdp or ssh), 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, and rust preinstalled.
  • Level 4: Emerald - Remote shell and tunnel support (via tmate, rdp or ssh), 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: