Install MineOS on Ubuntu 20.10

Updated on December 1, 2020
Install MineOS on Ubuntu 20.10 header image

This tutorial explains how to install MineOS on Ubuntu 20.10 using a Vultr cloud server. A cloud server instance is sometimes called a Virtual Private Server or VPS. MineOS is a self-hosted Minecraft server management system. It offers unlimited profiles and a beautiful WebUI with real-time analytics to manage multiple Minecraft servers running on your cloud server. Use this guide to host a Minecraft server and play with your friends.

Deploy a Vultr Server

1. Install Prerequisites

  1. SSH to the server instance as root.

  2. Update the list of packages for your system.

     # apt-get update
  3. MineOS requires nodejs JavaScript runtime environment, rdiff-backup to create reverse incremental backups, screen to run multiple pseudo-terminals, build-essentials, rsync, and the java platform. Install the dependencies:

     # apt-get install -y nodejs rdiff-backup screen build-essential rsync openjdk-8-jre-headless

2. Install NodeJS Version 10

  1. MineOS requires NodeJS version 10. The default repository installs newest version of NodeJS. To downgrade NodeJS, install Node Version Manager (NVM).

     # curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.0/install.sh | bash
  2. Run the following to set up the NVM environment, or close and reopen your terminal.

     # export NVM_DIR="$HOME/.nvm"
     # [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
     # [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
  3. Verify the NVM version.

     # nvm -v

    The version should be 0.37.0 or greater.

  4. Install NodeJS version 10.

     # nvm install 10
  5. Make version 10 the default.

     # nvm use 10
  6. Verify the NodeJS version.

     # node -v

    The version should be v10.23.0.

3. Install MineOS

  1. Change to the default script directory.

     # cd /usr/games/
  2. Clone the MineOS repository.

     # git clone https://github.com/hexparrot/mineos-node.git minecraft
  3. Navigate to MineOS directory.

     # cd minecraft
  4. Set Git to ignore changes in file permissions.

     # git config core.filemode false
  5. Make the following files executable.

     # chmod +x service.js mineos_console.js generate-sslcert.sh webui.js 
  6. Install NodeJS packages with root permission to run MineOS Web Interface.

     # npm install --unsafe-perm

    Note: Ignore any errors or warnings related to node-gyp rebuild.

  7. Add symlink from MineOS installation to your system.

     # ln -s /usr/games/minecraft/mineos_console.js /usr/local/bin/mineos
  8. Copy the MineOS configuration to your system configuration.

     # cp mineos.conf /etc/mineos.conf
  9. Set up the systemd service

     # cp init/systemd_conf /etc/systemd/system/mineos.service
  10. Enable MineOS.

     # systemctl enable mineos
  11. Start MineOS.

     # systemctl start mineos
     # systemctl stop mineos
  12. Generate a self-signed certificate for HTTPS.

     # ./generate-sslcert.sh
  13. Start the WebUI as a background daemon.

     # node service.js start

    In the future, to manage the WebUI, use the following commands.

     # node service.js start
     # node service.js stop
     # node service.js restart
     # node service.js status
  14. Add a user account such as example_username. Set a strong password for this user.

     # adduser example_username

4. Log in to the WebUI

  1. Navigate to the WebUI at port 8443 in your web browser. Replace the example with the IP address of your Vultr cloud server.

     https://192.0.2.123:8443
  2. Navigate past the security warning due to the self-signed certificate.

5. Create a Server

  1. Log in with the username and strong password you created, such as example_username.
  2. Click Create New Server on left pane.
  3. Fill in your Minecraft server settings.
  4. Click Profiles on left pane.
  5. Download available server packs or jars.
  6. Click Dashboard on left pane.
  7. Select your server.
  8. Click Accept EULA besides Start button.
  9. Click Start button.
  10. Select the profile and runnable jar you've downloaded.
  11. Log in with a Minecraft client.

6. Play Minecraft

Connect to the server by IP, or domain name if you created one. Use the port number configured in the MineOS server settings. The default port number is 25565.