Dogebox OS

A modern NixOS-based Linux distribution built for the Dogecoin community

Caution

Dogebox is currently in pre-alpha developer preview. Do not use it for production workloads or store significant funds in addresses generated by it.

What is Dogebox OS?

Dogebox OS is a specialized Linux distribution built on NixOS that provides a secure, containerized runtime environment for Dogecoin services and applications. This repository contains the NixOS flake configuration and build system for creating Dogebox OS images.

Key Features

• Built on NixOS: Leveraging the power of declarative, reproducible system configuration
• Container-based Architecture: Applications (called "Pups") run in isolated NixOS containers
• Secure by Design: Integrated authentication through the Doge Key Manager (DKM)
• Multiple Platform Support: Build images for x86_64, ARM64, and specific hardware like NanoPC-T6
• Web-based Management: User-friendly interface for system and application management

System Components

Dogebox OS integrates several key components:

Core Services

• dogeboxd - The system manager service that orchestrates all Dogebox operations
• dpanel - Web-based management interface for Dogebox
• dkm - Doge Key Manager for cryptographic operations and authentication

Additional Resources

• dogebox-nur-packages - Custom NUR packages for Dogebox

Getting Started

Downloading Dogebox OS

Pre-built images are available on our GitHub Releases page.

Running Dogebox OS

Detailed installation and usage instructions for various platforms can be found at dogebox.org.

Currently supported platforms:

• QEMU/KVM (x86_64 and ARM64)
• ISO images for bare metal installation
• NanoPC-T6 (ARM64 hardware)

Note

Current releases use default credentials: shibe:suchpass. You will be required to change the password on first login.

Repository Structure

This repository is organized as a NixOS flake with the following structure:

os/
├── flake.nix           # Main flake configuration
├── flake.lock          # Locked dependencies
├── nix/
│   ├── builders/       # Platform-specific builders
│   │   ├── iso/        # ISO image builder
│   │   ├── qemu/       # QEMU image builder
│   │   └── nanopc-t6/  # NanoPC-T6 specific builder
│   ├── dbx/            # Dogebox-specific NixOS modules
│   │   ├── base.nix    # Base Dogebox configuration
│   │   ├── dogebox.nix # Main Dogebox module
│   │   ├── dogeboxd.nix # dogeboxd service configuration
│   │   └── dkm.nix     # DKM service configuration
│   └── os/
│       └── common.nix  # Common OS configuration
└── docs/               # Documentation and assets

Flake Structure

The flake provides several outputs:

Packages

• iso - Bootable ISO images (x86_64, aarch64)
• qemu - QEMU/KVM disk images (x86_64, aarch64)
• t6 - NanoPC-T6 specific image (aarch64)

This provides all necessary tools for building and testing Dogebox OS images.

Documentation

For comprehensive documentation including:

• How to build images
• Installation guides
• Pup development
• API reference
• Security considerations

Please visit dogebox.org

Community

• Discord: Join the DogeDev Discord
• Issues: GitHub Issues

Contributing

We welcome contributions! Please:

1. Check existing issues and discussions
2. Open an issue to discuss significant changes
3. Follow the NixOS coding standards
4. Test your changes thoroughly