BYO Main Page

From MineOS Wiki
Jump to navigation Jump to search


There are hundreds of guides, handbooks, tutorials, videos, and walkthroughs on how to accomplish any given Linux task. build-your-own 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.

This wiki is a working wiki--and contains all the information to turn CRUX linux into a working server. This will be modified soon with the release of the next MineOS project which will AUTOMATE these steps for the user and will replace/supersede MineOS (microcore).


The original MineOS (and the community-run MineOS+) is aimed at creating the smallest possible minecraft server, automating the process as much as possible for the user, while compromising none of Linux' capabilities.

build-your-own MineOS is a entirely different project which does not attempt to replace MineOS/+. Instead, byo MineOS is an educational tool which aims to teach server admins about what components MineOS uses, walks you through how to properly add and configure each, and help you get a fully comprehensive understanding of how each mechanic makes for the best possible server.


Build-your-own MineOS is designed to be a collaborative project, (despite knowing I'll be producing most of the effort regardless). As a wiki, MineOS is open to user-contributions on improving these steps in order to make the most error-free, quick-start guide possible!

If you are unsure about your changes, always feel free to contact me directly at wdchromium at gmail--or use the :discussion page assigned to each wikipage. :discussion pages do not need to be polished and can be speculative or requests; I'll review each one personally to help improve the helpfulness of the wiki each time.

Who would build their own Linux/MineOS?

build-your-own MineOS is not a right-out-of-the-box solution. I will try my absolute best to provide all the steps required--from start to finish--to build it from the ground up, but doing so requires time, discipline, and an unwavering enthusiasm to learn. Expect to read through and execute steps more than once. Breaking Linux is the #1 to understand what is going on in the background, and getting everything working the first time probably means you are not experimenting. I promise you, repetition is the recipe for learning Linux from the inside-out.

build-your-own MineOS is not going to create a distribution like the already-existing MineOS, based on the microcore distrobution. byo MineOS 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.

This provides an ideal starting point for learning, providing 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 (such as Ubuntu Server). With all services running (but not Minecraft), byo MineOS takes approximately 53MB of RAM and uses 1000MB of hard disk space. While the disk space is dramatically higher than MineOS/+, this includes a the kernel-source tree, and an entire build environment -- complete to build any software from source that you please!

Getting started

For simplicity and convenience, I recommend using VirtualBox. Virtualbox is the best way to learn byo MineOS because of the rollback capabilities, ability to multitask in your normal OS, and the standardization of the virtualized hardware. While CRUX Linux (and thus byo MineOS) can be installed on ANY hardware (and any virtualization software), failure to identify your hardware and build it into the kernel can cause lots of time-waste and unnecessary frustration for the Linux novice.

Congratulations on deciding to learn Linux!

There are instructions to walk you through every step to build your own MineOS!

  1. Determine platform to install MineOS on
    1. Virtualbox
    2. VMWare
    3. VirtualPC
    4. Direct Install
  2. Download
    1. CRUX Linux iso (~231 MB) from the CRUX download page
    2. Virtualization software
      1. Virtualbox installer (~81 MB) from Oracle
      2. VirtualPC from Microsoft
      3. VMWare
  3. Prepare System
    1. Partition hard drives
    2. Format with filesystems
  4. Installing CRUX Linux
    1. Configure basic settings
    2. Configure network settings / Wireless
    3. Enable SSH connectivity
    4. Build Linux kernel
    5. Installing LILO
  5. Install additional packages
    1. python + sqlite3
    2. java
    3. rdiff-backup
    4. Webservers
      1. lighttpd
      2. Apache
      3. nginx
      4. MySQL
      5. PHP
  6. Configure OS features
    1. iptables (firewall)
    2. ramdisks
    3. crontabs
  7. Configure Additional software
    1. phpBB3
    2. MineOS python scripts
    3. Upgrading the Kernel

Troubleshooting / Common issues