You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
BuildTools f9eb8014a7 updated userid npm! 2 weeks ago
html able to add custom columns from sp to dashboard 1 month ago
init SHELL=/bin/bash 3 years ago
test adding test confirming previous commit 2 months ago
.gitattributes :space_invader: Added .gitattributes & .gitignore files 5 years ago
.gitignore changed .gitignore to nodejs based one 4 years ago
Dockerfile updated dockerfile for stretch/nodev8 1 year ago renamed gpl to 5 years ago update readme to get nodejs v8 1 year ago
auth.js fix for user with no matching username 2 months ago fixed 2 years ago Update (#320) 1 month ago
mineos.conf able to add custom columns from sp to dashboard 1 month ago
mineos.js Revert "query doesn't work on hosts with specific server-ip (#324)" (#328) 1 month ago
mineos_console.js fixed issue with mineos_console.js requiring servername for -V 1 year ago
package-lock.json updated userid npm! 2 weeks ago
package.json updated userid npm! 2 weeks ago
profiles.js Update FTB profile to use (#330) 1 month ago fixed npm install in 1 year ago
server.js able to add custom columns from sp to dashboard 1 month ago
service.js added systemd init scripts 4 years ago added --unsafe-perm to 1 year ago
webui.js Update the error message printed for SSL error (#326) 1 month ago

Node.JS MineOS

MineOS is a server front-end to ease managing Minecraft administrative tasks. This iteration using Node.js aims to enhance previous MineOS scripts (Python-based), by leveraging the event-triggering, asyncronous model of Node.JS and websockets.

This allows the front-end to provide system health, disk and memory usage, and logging in real-time.

This has been tested on Debian, Ubuntu, ArchLinux, and FreeBSD and should work on all variants, Linux or BSD.


MineOS is distributed through github and downloads its dependencies with npm.

MineOS requires root-privileges, as the authentication relies on the underlying system's /etc/shadow.

Do not install this atop an existing MineOS system (using the Python-based webui), since the installation location is the same /usr/games/minecraft. Following are steps for installing MineOS on an apt-get based distribution, such as Debian or Ubuntu. These instructions are detailed further (as well as for additional distributions) on the MineOS wiki.

Using an apt-get based Linux distribution:

curl -sL | bash -
apt-get update
apt-get install -y nodejs git rdiff-backup screen build-essential openjdk-8-jre-headless
mkdir -p /usr/games
cd /usr/games
git clone minecraft
cd minecraft
chmod +x
cp mineos.conf /etc/mineos.conf
npm install

For hosts using ‘upstart’:

cp /usr/games/minecraft/init/upstart_conf /etc/init/mineos.conf
start mineos

For hosts using ‘supervisor’:

cp /usr/games/minecraft/init/supervisor_conf /etc/supervisor/conf.d/mineos.conf
supervisorctl reread
supervisorctl update
supervisorctl start mineos

For hosts using ‘systemd’:

cp /usr/games/minecraft/init/systemd_conf /etc/systemd/system/mineos.service
systemctl enable mineos
systemctl start mineos

To use the webui as a background daemon:

node service.js [start|stop|restart|status]

To start the webui in the foreground:

node webui.js

Things to watch out for

On FreeBSD, you will need to mount a Linux-compatible /proc filesystem, i.e., linprocfs, at /usr/compat/linux/proc in order for the web-ui to work. In addition, where CLANG is default for your system, you'll need to build the NPM modules differently:

echo "CXX=c++ npm install" | sh

Mineos-node requires rsync 3.1.x or later, 3.0.x does not have the ability to chown on copy, which is essential for profiles. Depending on your distribution, you may need to build it from source.

Developing and Contributing

I'd love to get contributions from you! Whether you are most comfortable writing HTML, CSS, or Javascript (either Nodejs or Angular), feel free to reach out to me about some of my design goals and we'll see where your efforts can best be used.


See file.


Create an issue in github or start a post on the MineOS support forums.


The Angular.JS-based web user interface capable of:

  • creating and deleting servers,
  • starting, restarting, killing and stopping servers
  • backup, archive, wait-for-stop-and-backup
  • reading ingame console in real-time and submitting commands
  • create cronjobs for the most common tasks
  • adding and modifying
  • delete previous archives and restore poitns to free up space
  • restore server from previous restore point
  • see filesystem usage of live server files, archives, and restore points
  • authentication via shadow passwords (/etc/shadow) of underlying Linux system
  • logs all user actions to file
  • cronjobs saved to portable format cron.config
  • server can be daemonized to background
  • upstart/supervisord restart process on unhandled exceptions
  • easy selection of server packs from FTB or Mojang official jars
  • PHAR support for Pocketmine servers
  • Support for BungeeCord servers
  • command-line interface for scripting


  • macro often-repeated tasks from web-ui
  • more fully document functions


  • implement previous_versions: functionality to roll back or view particular files’ previous state
  • identify java versions in web-ui, allow choice of utilized jvm