Tutorial

Zero to a running server

Start to finish, this takes about 15–20 minutes of actual waiting (mostly Docker pulling images) and maybe 10 minutes of clicking. Do the steps in order the first time through.

1

Check the prerequisites

You need an Ubuntu Server (22.04 or 24.04 LTS) with sudo access, and its IP address or hostname on your local network. Full details, including hardware guidance, are on the prerequisites page — worth a skim if this is your first time setting up a Linux server.

Don't have Ubuntu Server installed yet? Any machine works — an old PC, a mini-PC, or a VM — as long as it can stay on. You don't need a powerful machine for a small server (see Prerequisites for real numbers).
2

Install Anvil Server Installer

SSH into your Ubuntu Server and run:

# over SSH, on the Ubuntu Server itself git clone https://github.com/TomCodes-sys/Anvil-Server-Installer.git cd Anvil-Server-Installer chmod +x bootstrap.sh ./bootstrap.sh

This installs Python, sets up a virtual environment, and starts the dashboard as a systemd service. At the end it prints a link with an access token baked in — something like:

http://192.168.1.50:8090/?token=xxxxxxxxxxxx

Open that link in a browser on the same network. Keep the token — it's also saved on the server at /etc/anvil-installer/token if you lose it.

This dashboard can run root commands on your server. Don't port-forward port 8090 to the internet — keep it LAN-only.
3

Click through the setup steps

Inside the dashboard, run each step in order — each one is re-runnable if it fails partway:

  • Update system & configure firewall — opens the ports Anvil needs, re-enables SSH first so you can't get locked out
  • Install Docker — required for Crafty
  • Install Crafty Controller — your login details appear automatically once it's done
  • Install Cockpit (+ Navigator) — a system admin panel and file manager, on port 9090

Once Crafty is up, open it (port 8443), click through the self-signed certificate warning (expected — it's your own server), and create your first Minecraft server from Crafty's own "Create a server" wizard.

4

Start your Minecraft server in Crafty

Pick a version and server type (Vanilla, Paper, Fabric, Forge, etc.), give it a name, and hit Create. Crafty downloads the server jar and sets everything up. Start it once to generate the world and the config files (server.properties, whitelist.json, and so on) that Anvil Mod Manager and Anvil Server Manager will both read.

5

Install Anvil Mod Manager

Back in the Installer dashboard, this is offered as an optional step — one click installs and starts it. Or install it by hand:

git clone https://github.com/TomCodes-sys/Anvil-Mod-Manager.git cd Anvil-Mod-Manager chmod +x bootstrap.sh ./bootstrap.sh

Open it on port 5151. In Settings, paste your Crafty URL and an API token (generate one from your Crafty user profile). Then in Server Setup, add your server's folder path and hit "Auto-detect all" to link it to the matching Crafty server by name.

6

Install Anvil Server Manager

Also offered as an optional step from the Installer, or by hand the same way:

git clone https://github.com/TomCodes-sys/Anvil-Server-Manager.git cd Anvil-Server-Manager chmod +x bootstrap.sh ./bootstrap.sh

It runs on port 6161, and prints its own access token the same way the Installer did. Once it's open, the Home tab links straight into the Installer and Mod Manager, and the Updates tab lets you check for Crafty/Docker/Cockpit updates from one place.

7

Set up backups (seriously, do this one)

In Anvil Server Manager's Backups tab: pick a local path (an external/second disk is ideal) or an S3-compatible/Backblaze B2 bucket, set a repository password, and click "Initialize repository." Add /opt/crafty/servers as a source path, turn on scheduling, and click "Run backup now" once to confirm it works end to end.

While you're there, add a Discord webhook in Notifications so you hear about backup failures instead of finding out the hard way.

8

You're done — what to explore next

From here it's all optional extras: the RCON console for quick commands without opening Crafty, the Players tab for whitelist/ops/bans, and the Logs tab if a server ever crashes and you want a plain-English guess at why. Check the FAQ if anything comes up.

Ready to start?

Grab the Installer and follow along from step 2.

Download