---
title: Ubuntu Linux Setup
description: "This guide will walk you through setting up the Elements Local SDK on an Ubuntu-based system. You’ll install the required dependencies manually or use the provided setup script for convenience. --- ## Manual Step-by-Step Installation ### 1. Install OpenJDK Install…"
url: "https://namazustudios.com/docs/custom-code/ubuntu-linux-setup/"
updated: "2026-08-13"
category: "Your Game Code - Adding Custom Elements"
---

# Ubuntu Linux Setup

This guide will walk you through setting up the Elements Local SDK on an Ubuntu-based system. You’ll install the required dependencies manually or use the provided setup script for convenience.

---

## Manual Step-by-Step Installation

### 1. Install OpenJDK

Install OpenJDK 21(or later):

```
sudo apt update
sudo apt install openjdk-21-jdk -y
```

Verify the installation:

```
java -version
```

---

### 2. Install Maven

Install Maven using APT:

```
sudo apt install maven -y
```

Verify the installation:

```
mvn -version
```

---

### 3. Install Git (if not already installed)

```
sudo apt install git -y
```

---

### 4. Install IntelliJ IDEA (Optional but Recommended)

You can install IntelliJ IDEA via Snap:

```
sudo snap install intellij-idea-community --classic
```

Or download from:
[https://www.jetbrains.com/idea/download/](https://www.jetbrains.com/idea/download/)

---

### 5. Clone and Import the Example Project

Clone the Elements example project:

```
git clone https://github.com/NamazuStudios/element-example.git
```

Then:

1. Open IntelliJ IDEA
2. Click **Open** and select the `Element-example` directory
3. If prompted, import as a Maven project
4. If not prompted, right-click `pom.xml` and select **Add as Maven Project**

---

### 6. Run the Local SDK

1. In IntelliJ, navigate to the `dev.getelements.sdk.local` package
2. Locate and run the `LocalSdkMain` class (or the appropriate main class)
3. The local server should boot up and be accessible for testing

---

## Full Setup Script (For Convenience)

To install everything in one shot, run the following in a terminal:

```
sudo apt update
sudo apt install openjdk-21-jdk maven git -y
```

To install IntelliJ (optional):

```
sudo snap install intellij-idea-community --classic
```

---

## You’re Ready

Once you’ve completed the setup:

- You can build and run the Elements example project locally
- You’re now ready to begin backend development using the Elements SDK