MineOS CRUX: Minecraft hosting improved

a comprehensive guide to a completely managed, self-contained minecraft server

Notice about MineOS CRUX discontinuation

As of mid-July 2013, MineOS CRUX is being discontinued in favor of MineOS Turnkey or other variants such as MineOS-on-Ubuntu/FreeBSD, which will be continued in production. CRUX has run its course as the minimalist, secure distribution but is replaced by the hardened and proven Debian-based Turnkey. CRUX ISOs are available for archival purposes only but support will still be provided for those interested in learning CRUX, rather than using it as a production system.

The upcoming 0.6.x scripts will be distributed via Debian/Ubuntu packages, manual rsync installation, and the MineOS Turnkey ISO.


MineOS CRUX is a specialized distribution with a specific goal: To provide the ultimate server solution for Minecraft and to provide a robust and extendible platform for server mods and related value-added functionality.


MineOS CRUXis a entirely different project than MineOS with the same goals on a different platform. MineOS CRUX is a fully-featured and optimized server distributionthat follows familiar Linux conventions to create a high-powered, intuitive, server configuration.

What does MineOS CRUX offer over other Linux Distributions?

MineOS has always aimed for a very niche audience--this aim has the downside a smaller community than general server solutions, such as Ubuntu Server. On the other hand, it has the upside of having a much more targetted and relevant set of applications and documentation to get it working the way it needs to be.

I do not believe MineOS CRUX is the only server distro you should consider using to host Minecraft--quite the opposite: MineOS simply demonstrates what components make for a solid, stable server; it aims to include all the functionality a Minecraft admin should have while trimming out all the fat.

To provide a one-stop answer to Minecraft hosting, the following features are pre-configured, optimized, and/or available as tools at your disposal. For a full list, see the features page.

  1. Web-based server admin page
    -remotely manage your servers, backups, archives, mapping, and console from your browser
  2. Improved, incremental world backups
    -space-efficient and precise rdiff-backup method using the rsync algorithm
  3. Single-click updating of the user-interface and server mods (such as vanilla, bukkit, tekkit)
  4. Safer, more secure implementation/OS
    -MineOS follows the close everything, then open-what-you-need methodology.
  5. Ramdisk setup for better responsiveness
  6. And an incredibly small memory footprint, leaving your server with the most resources of any distro you'll ever use.

MineOS CRUX uses CRUX Linux. From the CRUX website,

CRUX is a lightweight, i686-optimized Linux distribution targeted at experienced Linux users. The primary focus of this distribution is keep it simple, which is reflected in a straightforward tar.gz-based package system, BSD-style initscripts, and a relatively small collection of trimmed packages.

Fortunately, I have labored over the installers, scripts and configuration files exhaustively to make MineOS CRUX palatable even to a Linux novice. Those familiar with Linux should be able to embrace MineOS CRUX easily. Why? Because under the hood, it is the same Linux you would get from CRUX Linux, a stable, hardened distribution--with MineOS trimmings on the top.

Getting started

Technical documentation and instructions are best left to a wiki: MineOS CRUX wiki. Here you will find comprehensive instructions and step-by-step screenshots for every step getting your server up and running!

  1. Download the MineOS ISO for your architecture: x86 / x64 (~200MB)
  2. Burn the ISO to a cd/dvd and boot in your machine
    Boot the ISO from your favorite virtualization software
  3. Login at the prompt as 'root'
  4. Run the installation script 'setup'
  5. Follow the instructions for partitioning, installing, configuring, then reboot.
  6. You are ready to create a Minecraft server!
    -Instructions are provided at the end of the setup process as well as in the wiki in greater detail.

Your server's webUI page is accessible at: http://<ipaddress>/admin or https://<ipaddress>:443/admin. Both are available, according to your preferences. From there, use the login and password you set during the installer and youre good to go!


Your server works! Go and play!