Linux Setup Documentation


General Installation Notes

Install Script

sudo apt update
sudo apt upgrade
sudo apt install git
git clone && cd crafty-installer-4.0 && sudo ./
sudo su crafty
cd /var/opt/minecraft/crafty

Manual installation steps (for Ubuntu/Debian, CentOS)

Requirements & Assumptions


Install Required Software

On Ubuntu/Debian variants, you can install required software via the command line by typing:

sudo apt install git python3 python3-dev python3-pip software-properties-common openjdk-8-jdk openjdk-8-jre

On CentOS variants:

sudo dnf groupinstall "Development tools"
sudo dnf install python3 python3-devel java-1.8.0-openjdk java-1.8.0-openjdk-devel
Create a directory for Crafty

Let's make crafty a place to live on your server. This guide will use /var/opt/minecraft/crafty as it's example.

sudo mkdir -p /var/opt/minecraft/crafty
sudo mkdir -p /var/opt/minecraft/server
Create a Crafty User Account
sudo useradd crafty -s /bin/bash
Change to the Crafty dir
cd /var/opt/minecraft/crafty
Clone Crafty Repo

Please be sure to be in the crafty folder before cloning the repo.

sudo git clone
Create a Virtual Environment
sudo python3 -m venv venv
Setup permissions for the folders
sudo chown crafty:crafty -R /var/opt/minecraft
sudo su crafty -
Activate the Virtual Environment
source venv/bin/activate
Go into the crafty-4 folder that was cloned down
cd crafty-4
Install all the things / requirements
pip3 install --no-cache-dir -r requirements.txt
Run Crafty:

Make sure you're still in crafty-web.


That's it! Crafty should now be running and asking some install questions. If you get stuck or Need help? Click here!

Updating Crafty

Update After Install Script

cd /var/opt/minecraft/crafty 
sudo su crafty

Update After Manual Install

cd /var/opt/minecraft/crafty/crafty-4
git pull
If you experience git telling you to commit or stash local changes and you have not made any changes run git reset --hard origin/master in the crafty-4 directory. If you have made changes you might want to stash them, but popping them could cause adverse effects.


Check out the Getting Started page.