# MineOS-node

MineOS-node is a Node.js-based web interface for managing Minecraft server administrative tasks. It is open source and self-hosted, installable on TrueNAS, Docker Hub, ZimaOS and Unraid.

Canonical page: https://ourlocalhost.com/app/606/mineos-node

## Description

MineOS-node is a Node.js-based web interface for managing Minecraft server administrative tasks. It provides real-time system health monitoring, disk and memory usage tracking, and live logging through an asynchronous, event-driven architecture. Built for homelabbers and self-hosters running one or more Minecraft servers who prefer a browser-based dashboard over manual shell configuration.

## Platform availability

Available on 3 of 9 platforms: Unraid, TrueNAS, ZimaOS.

## Health score

28/100 (Low), based on 3 of 4 factors.
- Maintained: 1 (last commit 723 days ago)
- Popular: 51 (365 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)

## Links

- GitHub: https://github.com/hexparrot/mineos-node
- TrueNAS: https://apps.truenas.com/catalog/mineos
- Docker Hub: https://hub.docker.com/r/hexparrot/mineos
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/MineOS
- Unraid: https://ca.unraid.net/apps/mineos-node-0kkqvi410eyijc?q=MineOS-node

## Common questions

### What default credentials and ports should I check when first accessing MineOS-node?

The default login is mc with password mypass, and the web port defaults to 8443. The default Minecraft ports are 25565 through 25575, with the container path at /var/games/minecraft and optional storage path at /mnt/data.

### Can MineOS start the same Minecraft server on another PC after a power outage?

A Reddit thread asks whether MineOS can support high availability by starting the same server on another PC after a power outage, and it clarifies limits around failover and shared IP access.

### What Java version issue should I consider when running Minecraft 1.20.5?

Minecraft 1.20.5 requires Java 21, which can create a MineOS compatibility problem. The thread helps users troubleshoot that Java version issue.

### Was MineOS reported to be easy for creating a modded Minecraft server in unRAID?

A user found MineOS difficult to use for creating a modded Minecraft server in unRAID and asked for an easier way.

---
Source: Our Local Host (https://ourlocalhost.com/app/606/mineos-node), the self-hosted and open-source app directory.