MineOS adaptation for Synology DiskStation Manager (DSM) 7.x
This project adapts MineOS-node, a web-based Minecraft server management interface, to run as a Synology SPK package on DSM 7.x systems.
Target Platform: Synology DS920+ (geminilake architecture) running DSM 7.2
- 📦 Easy Installation: Install via DSM Package Center
- 🔐 DSM Authentication: Login with your existing DSM credentials
- 🎮 Multi-Server Management: Create and manage multiple Minecraft servers
- 💾 Automated Backups: Schedule backups and restore from previous points
- 📊 Real-time Monitoring: View server status, console output, and resource usage
- 🔄 Seamless Upgrades: Update without losing your server data
- 🔒 Secure: Runs as non-privileged user, isolated from system
🎯 MVP Complete (100%) - Ready for testing on physical NAS
- ✅ Phase 1: Setup (100%)
- ✅ Phase 2: Foundational (83%)
- ✅ Phase 3: User Story 1 - Installation & Authentication (100%)
- 📦 SPK Package:
MineOS_geminilake-dsm70_20251116_v2.spk(43 MB) - 📊 Overall Progress: 57/264 tasks (21.6%)
Next Steps: Install and test on DS920+ with DSM 7.2, then continue with User Story 2 (Server Management)
- Installation Guide - Complete installation instructions
- Installation Tests - Testing procedures (T050-T057)
- Test Checklist - Detailed test checklist
- Next Steps - Roadmap and upcoming features
- Build Instructions - How to build the SPK package
- Architecture - Technical design and implementation
- Specifications - Detailed project specs
- Tasks - All 264 development tasks
- Session 2025-11-17 - Latest session (MVP completion)
- Session 2025-11-15 - Previous session
- Bug Fixes - Resolved issues
# Clone repository avec submodules
git clone --recursive <repo-url>
cd Mineos
# Lancer le guide interactif
./quickstart.shLe script quickstart.sh vous guidera à travers:
- Vérification de l'environnement (Docker, Git, etc.)
- Sélection de l'architecture cible
- Construction du package SPK
- Déploiement sur votre NAS
# Vérifier l'environnement
./scripts/check-build-env.sh
# Build pour DS920+ (geminilake)
./build-spk.sh
# Ou pour une autre architecture
./build-spk.sh apollolake 7.0
# Le package sera créé: MineOS_[arch]-dsm[version]_[date].spkVia DSM Package Center:
- Transférez le fichier .spk sur votre ordinateur
- DSM → Centre de paquets → Installation manuelle
- Sélectionnez le fichier SPK
Via SSH:
scp MineOS_*.spk admin@your-nas-ip:/tmp/
ssh admin@your-nas-ip
sudo synopkg install /tmp/MineOS_*.spk
sudo synopkg start MineOSAccès:
https://your-nas-ip:8443
.
├── spk/ # SPK package structure
│ ├── INFO # Package metadata
│ ├── scripts/ # Installation/service scripts
│ ├── conf/ # Configuration templates
│ └── ui/ # Package Center UI
├── mineos-node/ # MineOS-node upstream (submodule)
│ └── dsm-patches/ # DSM-specific adaptations
├── build/ # Build infrastructure
│ └── spksrc/ # spksrc framework (submodule)
├── tests/ # Integration and manual tests
├── docs/ # User and developer documentation
└── specs/ # Design documents and tasks
- Synology NAS with DSM 7.0 or higher
- x86_64 architecture (DS920+, DS918+, etc.)
- At least 4GB RAM (8GB recommended)
- Java 8+ (available via DSM Package Center)
- Linux, macOS, or WSL2
- Docker (for building SPK)
- Git
- SSH access to test NAS
🚧 In Development - See tasks.md for progress
Completed:
- ✅ Phase 1: Setup and directory structure
- ✅ Phase 2: Foundational infrastructure (SPK scripts, DSM patches, config loaders)
- ✅ Phase 3: User Story 1 - Integration and build system (DSM auth, paths, build configuration)
- ✅ Build automation (scripts, Docker integration, multi-arch support)
- ✅ Complete documentation (installation, build, architecture, tests)
Current Phase: Ready for build and testing Next Steps:
- Build SPK package with Docker (
./build-spk.sh) - Test installation on DS920+ DSM 7.2
- Implement server management features (Phase 4)
GPL-3.0 (inherited from MineOS-node)
- Original MineOS-node by hexparrot
- spksrc framework by SynoCommunity
- Adaptation for DSM by this project