Basalt
Getting started

Your first instance

Deploy a Minecraft server from template to join address.

With a node connected, you're three clicks away from a running server. This walkthrough uses the official Minecraft template; any other template works the same way.

Pick a template

Go to Instances → New instance. Choose the node to run on and pick the Minecraft (itzg/docker-minecraft-server) template.

Templates define everything Basalt needs to know about a game: the Docker image, supported versions, environment variables and the settings form you're about to see.

Configure the server

The template renders a full settings form: server type, version, memory, world options, whitelist and more. Every field has a sensible default, so for a first run you only need:

  • Name: what the instance is called in the panel.
  • Version: the Minecraft version to run.
  • Memory: how much RAM the container may use.

Anything you set here becomes environment configuration for the container. You can change most settings later and re-deploy.

Deploy

Hit Deploy. The daemon pulls the Docker image, creates the container with your configuration and starts it. You can watch progress live; the instance page shows status transitions and the console starts streaming as soon as the server boots.

Let players in

Players need a way to reach the server:

  • Same network: connect to the node's LAN address and the server port.
  • Port forwarding: forward the game port on your router to the node.
  • Tunnel: no router access needed, but you need a tunnel server first. With one configured, open the instance's Tunnel tab, enable the tunnel and share the address it shows. See the tunnels guide.

Where to next

On this page