From MineOS Wiki
Jump to navigation Jump to search


MineOS CRUX is a fully-featured Linux distribution designed for an administrator who wants the power and flexibility of a mainstream distro such Ubuntu Server, but slimmed down, fine-tuned and 100% ready-to-host Minecraft. MineOS CRUX comes with the an interactive web-user interface for managing your Minecraft servers, MySQL for mods and PHP/Hiawatha webserver for hosting forums or image galleries. And with all these features, MineOS CRUX's memory footprint is smaller than any other--about 25MB! See for yourself how MineOS CRUX can provide you a fast, secure, and easy to use platform to host Minecraft! (See full Feature List)

To view the easy-installation process, see the youtube video walkthrough


As of July, 2013, MineOS CRUX has been discontinued in response to a few emerging factors. See the new distro-agnostic web-ui instead.

  1. MineOS CRUX's ISO, now almost 2 years old, is no longer upkept. While the underlying operating system/distro still was functional, it was distributing an older version of the scripts (0.4.x) as well as relied on a now-defunct, versionless URL for Minecraft vanilla server. Since Minecraft no longer has a consistent URL (starting with 1.6.1), this means a new ISO has to be spun each time Minecraft updates, which is a tremendous waste of time, effort and bandwidth. Even though MineOS Turnkey will be maintained in this fashion, the easy re-spinning nature of Turnkey, as well as its modernness makes Turnkey a cinch compared to CRUX.
  2. MineOS' popularity has steadily increased over the years, drawing in new admins each month. This has led to a greater variety in hardware support than what CRUX was designed for, in terms of minimal footprint/hardware compatibility trade-offs. At this point, while CRUX still is useful to large amounts of users, its usefulness is marginalized by the ubiquity of support and standards of Debian, from which Turnkey is based. In addition, the popularity of MineOS-on-Ubuntu (and recently MineOS-on-FreeBSD) lends for a more modern operating system, more secure, more easily supported, and most importantly, most user-friendly experience.


There are hundreds of guides, handbooks, tutorials, videos, and walkthroughs on how to accomplish any given Linux task. MineOS is one of those (or all of them), but with a single twist: it is specifically tailored to create a Minecraft server. In this way, I greatly simplify the process by filtering out all the overwhelming and unnecessary tasks listed in normal guides, and I can focus strictly on the Minecraft-relevant ones; I provide a targeted approach to building Linux, learning its internals, and successfully hosting Minecraft.


The original MineOS aimed at creating the smallest possible minecraft server, automating the process as much as possible for the user, while compromising none of Linux' capabilities.

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

See a MineOS comparison

Who would use MineOS CRUX

MineOS CRUX is an out-of-the-box solution, but to use it and to maintain it properly does require time and effort. On the upside, you have infinitely more flexibility using this configuration and access to an expansive repository of packages available to CRUX installations.

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.

MineOS CRUX is within the reach of the Linux novice as much as (or more so) than generic server distributions; combining a comprehensive wiki and Youtube videos, MineOS CRUX provides an ideal starting point for learning. MineOS CRUX provides a perfect balance between the flexibility and control of Linux from scratch (which is exceedingly unforgiving of mistakes) and a standard server which provides no Minecraft-related instruction.

In addition, any admin who wants to maximize their hardware's performance should consider MineOS CRUX: with all services running (but not Minecraft), MineOS CRUX takes a tiny ~25MB of RAM and uses only 650MB of hard disk space. This includes the webserver, MySQL database, extensive driver support in the kernel, and an entire build environment--complete to build and deploy any software from source that you please!

25MB footprint after 20 minutes of idle

Getting started

MineOS CRUX is designed to be installed directly to the hard drive of a physical server. However, special care has been taken to ensure its full operability within Virtual environments. If you are new to Linux or just want to testdrive MineOS, I recommend using VirtualBox. Virtualbox will leave your current OS intact, while giving you a chance to explore the Operating system and all its features in its entirety.

There are instructions to walk you through every step of installing MineOS CRUX!

For a youtube video walkthrough, http://www.youtube.com/watch?v=zkqkxvtpsd4

  1. Determine platform to install MineOS on
    1. Physical hardware as the primary OS
    2. Virtualbox - download
    3. VMWare Player - download
    4. VirtualPC - download
    5. Parallels Desktop
  2. Download MineOS CRUX ISO
    1. x86 iso (~200MB)
    2. x64 iso (~210MB)
  3. Installing
    1. Main 'setup' steps
    2. Post-Install Configuration
  4. Using MineOS
    1. Web-interface basics/starting a new world
    2. Importing a pre-existing world
    3. Readme / Console Commands
    4. MineOS Extensions - "Addons"

Quick Links