Install on Linux

System Requirements

Before starting the installation, ensure your system meets the following requirements:

Ubuntu 22.04 LTS or later
Debian 12 or later

Note

If your Linux distribution isn’t Ubuntu 22.04 LTS+ or Debian 12+, or your CPU architecture isn’t x86_64, consider running Endstone inside Docker instead. See Run with Docker.

Installation

Install uv

Using the official install script (recommended):


curl -LsSf https://astral.sh/uv/install.sh | sh

If your system doesn’t have curl, you can use wget:


wget -qO- https://astral.sh/uv/install.sh | sh

Create a virtual environment


uv venv

Activate the virtual environment


source .venv/bin/activate

Install Endstone


uv pip install endstone

Next steps

Continue to First Steps to learn how to run the server, configure it, and join.