Skip to content

Lodestone-Team/lodestone

Repository files navigation

Lodestone Screen Shot

Contributors Issues Build

Lodestone

A free, open source server hosting tool for Minecraft and other multiplayers games. Lodestone is designed to be easy to use, secure, and feature-rich. It is built with Rust, React, and TypeScript.

🔗 Get Started: https://www.lodestone.cc/

Features

  • Clean and intuitive UI
  • One-click installation and setup
  • Real-time server status
  • (New!) Beautiful and functional file manager (unzip, upload, download, copy, pastes, etc.)
  • Collaborative remote server and resource management
  • Priority on safety and security
  • User permission management
  • (New!) Extensions via macro (read more here)
  • (New!) Connect without port forward via playit.gg integration (read more here)
  • (New!) Manage Docker containers (WIP 🚧, read more here)

Future Features

  • Plugin and mod management
  • Complete Docker integrations
  • Event viewer

Have a feature request? Let us know by creating an issue!

Supported Platforms and Architectures

  • Windows (x86_64)
  • Linux (x86_64 and ARM)
  • MacOS (Apple Silicon)

We are deprecating support for Intel Macs due to the lack of hardware to test on. Get in contact with us if you would like to see additional platform supports.

Lodestone CLI vs Lodestone Desktop

Lodestone CLI manages the installation and updates of Lodestone Core - the backend of Lodestone. It does not come with a UI (dashboard), so you must use a web dashboard, either hosted by us or yourself.

Lodestone Desktop integrates Lodestone Core and the dashboard into a single application. It is available for Windows only and is not considered stable yet.

Installation

Docker

See here

Windows

You can download Lodestone Desktop for Windows from the releases page. Although we recommend using the CLI, see below.

Linux and MacOS (Apple Silicon) via CLI

Download and run Lodestone CLI.

If you would like to use the dashboard we hosts:

  1. Use a chromium based browser (Chrome, Edge, Brave, etc.) and go to https://www.lodestone.cc/
  2. Follow this guide to enable mixed content for the site.
  3. If you have browser extensions such as HTTPS Everywhere, disable them for the site.

To see why step 2 and 3 are necessary and some possible solutions, see here

Alternatively, you can host the dashboard yourself.

Safety & Security

Lodestone Core is written entirely in safe Rust, and uses#![forbid(unsafe_code)]. However we can't guarantee the safety of the crates and binaries we link to, as those may use unsafe rust.

Lodestone is created with security as a top priority. While most of the safety critical code such as login and permissions management have been tested thoroughly, no formal security audit has been done for any part of Lodestone.

Contributing

Lodestone is still new and we have a lot of features planned for this year. Either way, we'd love to hear your feedback! If you have any suggestions, leave a GitHub issue or talk to us on our Discord.

License

The Lodestone project uses the GNU Affero General Public License v3.0. See our LICENSE file for details.

Lodestone and all its components (dashboard, core, macros, etc.) are free for personal use, forever.

You may use Lodestone for commercial purposes, but you must disclose the source code of any modifications you make to Lodestone. You must also disclose the source code of any software that uses Lodestone's API.

Lodestone team provides absolutely no warranty or guarantee for the software.

For an alternate (non-AGPL) license, contact us by either raising an issue or joining our Discord.

Team

Lodestone wouldn't be here if it weren't for our contributors. Check out our team here!

Support Us

The Lodestone project is being maintained by a passionate team of University students with 0 profits. Consider buying us a coffee to support our development, we would greatly appreciate it!

Have questions?

Checkout our FAQ here for more info: https://github.com/Lodestone-Team/lodestone/wiki/FAQ

You can also join our Discord to ask questions and help for setting up Lodestone.

(back to top)