Azahar Helm Chart Repository

This repository contains a production-ready Helm chart for deploying Azahar on Kubernetes.

About Azahar

Azahar is a free and open-source Nintendo 3DS emulator (based on Citra). This chart deploys the linuxserver.io build, which serves the full emulator desktop in your browser over KasmVNC — no local install needed, play from any device on your network:

• 🎮 Full 3DS emulator desktop, streamed over the browser (KasmVNC)
• 🖥️ No client install — works from any modern browser
• 🗄️ BIOS/config/save persistence via a mounted /config volume
• 🎯 Bring your own ROMs/BIOS library via extraVolumes
• ⚡ Optional VA-API GPU passthrough for hardware-accelerated rendering

Quick Start

Add Helm Repository

helm repo add azahar-helm-chart https://henriqzimer.github.io/azahar-helm-chart/
helm repo update

Install Chart

helm install my-azahar azahar-helm-chart/azahar --version 1.0.5

For detailed installation instructions and configuration options, see the chart README.

Repository Structure

.
├── chart/              # Helm chart for Azahar
│   ├── Chart.yaml      # Chart metadata
│   ├── values.yaml     # Default configuration values
│   ├── README.md       # Detailed chart documentation
│   └── templates/      # Kubernetes manifest templates
├── LICENSE             # Repository license
└── README.md           # This file

Documentation

• Chart Documentation - Complete installation and configuration guide
• linuxserver.io Azahar Docs - Upstream image documentation
• Values Reference - All available configuration options

Prerequisites

• Kubernetes 1.19+
• Helm 3.0+
• Persistent storage, if you enable persistence.config (NFS, local-path, or cloud storage)
• (Optional) Ingress controller
• (Optional) cert-manager for automatic TLS
• (Optional) A node exposing /dev/dri for GPU passthrough

Features

This Helm chart provides:

• ✅ Production-ready Kubernetes Deployment/Service
• ✅ Optional persistent /config volume (BIOS, settings, saves)
• ✅ extraVolumes/extraVolumeMounts for a ROMs/BIOS library
• ✅ Optional Ingress with TLS support
• ✅ Resource limits and requests
• ✅ Readiness/liveness probes
• ✅ Configurable ServiceAccount
• ✅ Optional VA-API (/dev/dri) GPU passthrough

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See CONTRIBUTING.md.

License

This Helm chart is licensed under the MIT License - see the LICENSE file for details.

Azahar itself is licensed under its own terms. See the Azahar project and the linuxserver.io image for more information.

Support

• 🐛 Report Issues
• 💬 Discussions
• 📖 Documentation

---

Made with ❤️ for the retro gaming community