Skip to content
  • Our Product
    • Namazu Elements
      • What is Elements?
      • Why open source?
      • Docs
        • Elements in Five Minutes or Less
        • RESTful APIs Library
        • Security Model
        • Accessing the Web UI (CMS)

    Our Product

    A logomark with three layered rhombuses adorning the lettermark that says Elements in bold all-caps sans-serif letters.
    • What is Namazu Elements? Discover our easy-to-use backend network solution built for online games. Rapidly enables full-scale multiplayer games or online solo adventures.
    • Why open source? Is there a truly open source server backend for connected games? There is now. Download and run a local copy of Namazu Elements and try it for yourself.
    Download Namazu Elements

    Get started

    • Quick start Read our Elements 5-minute quick start guide
    • Documentation Read our developer docs for learning more about Elements
    • RESTful APIs A full list of core API specs for working with the Elements framework
    • Security An overview of the server-authoritative security model of Elements
    • Accessing the CMS Manage your game with ease via the Namazu Elements CMS.

    Co-development Reimagined

    • Reduce your costs Would you rather outsource your backend development? Hire Namazu Studios to build your server backend with the power of Namazu Elements.
      Co-dev

    Recent Posts

    • Namazu Studios Featured in San Diego Business Journal
      22 Sep 2025 Press
    • Namazu Elements 3.1 Released – Service Layer Fixes, Secure APIs, and Steam Bug Fix
      22 Apr 2025 Release Notes
  • Case Studies
  • About Us
  • News
  • Services
  • Book a call
namazu-studios-logo
Book a call

Getting Started

  • Elements in Five Minutes or Less
  • 🐧Ubuntu Linux Setup
  • 🍎 Mac OS Setup
  • 🖥️ Setup for Windows
  • Accessing the Web UI (CMS)
  • General Concepts
  • N-Tier Architecture
  • Security Model

Namazu Elements Core

  • User Authentication / Sign In
    • What is a User?
    • User Authentication in Elements
    • Auth Schemes
      • Auth Schemes
      • OAuth2
      • OIDC
  • Features
    • Applications
    • Sessions
    • Users and Profiles
    • Digital Goods
    • Progress and Missions
    • Progress and Missions (3.4+)
    • Leaderboards
    • Matchmaking – Comprehensive Guide
    • Followers
    • Friends
    • Reward Issuance
    • Save Data
    • Metadata
    • Metadata (3.4+)
    • Queries
    • Web3
      • Wallets
      • Vaults
      • Omni Chain Support
      • Smart Contracts
        • Smart Contracts
  • Queries
    • Advanced Operators
    • Object Graph Navigation
    • Boolean Queries
    • Base Query Syntax
  • Advanced Operators
    • .name
    • .ref

Custom Code

  • Custom Code Overview
  • Introduction to Guice and Jakarta in Elements
  • Structuring your Element
  • Packaging an Element with Maven
  • Deploying an Element
  • Preparing for Code Generation
  • Properties
  • Websockets
  • RESTful APIs
  • Direct MongoDB Access (3.5+)

Releases

  • 3.4 Release Notes
  • 3.3 Release Notes
  • 3.2 Release Notes
  • 3.1 Release Notes

Configuration

  • Matchmaking – Comprehensive Guide
  • Direct Database Access and Batch Configuration
  • Batch Samples
    • Mission Upload Bash Script Sample
    • Item Upload Bash Script Sample

RESTful APIs

  • RESTful APIs Library
  • Swagger and Swagger UI

Crossplay

  • Namazu Crossfire
  • Deploying Namazu Crossfire in Your Game
View Categories
  • Home
  • Docs
  • Getting Started
  • 🐧Ubuntu Linux Setup

🐧Ubuntu Linux Setup

Est. read time: 1 min read

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/


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
What are your Feelings
Still stuck? How can we help?

How can we help?

Updated on October 30, 2025
Elements in Five Minutes or Less🍎 Mac OS Setup
Table of Contents
  • 🛠 Manual Step-by-Step Installation
    • 1. Install OpenJDK
    • 2. Install Maven
    • 3. Install Git (if not already installed)
    • 4. Install IntelliJ IDEA (Optional but Recommended)
    • 5. Clone and Import the Example Project
    • 6. Run the Local SDK
  • ⚡ Full Setup Script (For Convenience)
  • ✅ You’re Ready
  • Documentation
  • Terms of Service
  • Privacy Policy
  • Contact us
  • Linkedin
  • Join our Discord

Namazu Studios LLC is powered by Namazu Elements, an Elemental Computing Inc. product.

Elements
  • Download
  • About Elements
  • Open source
  • Documentation
  • Support
About Namazu
  • Case Studies
  • About Us
  • News
Get in Touch
  • info@namazustudios.com
  • Book a call
  • (619) 862-2890
  • Linkedin
  • Discord

©2008-2025 Namazu Studios. All Rights Reserved.