truenas-iocage-mineos

Script to create an iocage jail on TrueNAS and install MineOS

Status

This script will work with TrueNAS CORE 13.0

Usage

Prerequisites

You will need to create

• 1 Dataset named mineos in your pool. e.g. /mnt/mypool/apps/mineos

If this is not present, a directory /mineos will be created in $POOL_PATH. You will want to create the dataset, otherwise a directory will just be created. Datasets make it easy to do snapshots etc...

Installation

Download the repository to a convenient directory on your TrueNAS system by changing to that directory and running git clone https://github.com/tschettervictor/truenas-iocage-mineos. Then change into the new truenas-iocage-mineos directory and create a file called mineos-config with your favorite text editor. In its minimal form, it would look like this:

JAIL_IP="192.168.1.199"
DEFAULT_GW_IP="192.168.1.1"
POOL_PATH="/mnt/mypool/apps"

Many of the options are self-explanatory, and all should be adjusted to suit your needs, but only a few are mandatory. The mandatory options are:

• JAIL_IP is the IP address for your jail. You can optionally add the netmask in CIDR notation (e.g., 192.168.1.199/24). If not specified, the netmask defaults to 24 bits. Values of less than 8 bits or more than 30 bits are invalid.
• DEFAULT_GW_IP is the address for your default gateway
• POOL_PATH is the path where the script will create the mineos folder if the mineos dataset was not created. It is best to create a dataset inside this path called mineos.

In addition, there are some other options which have sensible defaults, but can be adjusted if needed. These are:

• JAIL_NAME: The name of the jail, defaults to "mineos"
• INTERFACE: The network interface to use for the jail. Defaults to vnet0.
• JAIL_INTERFACES: Defaults to vnet0:bridge0, but you can use this option to select a different network bridge if desired. This is an advanced option; you're on your own here.
• VNET: Whether to use the iocage virtual network stack. Defaults to on.

Execution

Once you've downloaded the script and prepared the configuration file, run this script (script mineos.log ./mineos-jail.sh). The script will run for maybe a minute. When it finishes, your jail will be created, MineOS will be installed, and you will be shown the user and password to log in to the webui.

Reinstalling

• This script supports reinstalling and keeping your servers intact.
• It will just reinstall overtop of your existing data, and should detect them on a reinstall.

Notes

• The mineos data files are located in /var/games/minecraft
• The default user and password is mineos and mineos