Skip to content

amphi2024/server

Repository files navigation

Amphi Server

A simple Minecraft-like self-hosted server for Amphi Notes, Music, Photos, and Cloud.

preview

Setup

You can host your server using Java Runtime. If this guide feels complicated, check out our step-by-step YouTube Tutorial.

First, download the server from GitHub Releases.

curl -L https://github.com/amphi2024/server/releases/download/v?.?.?/server-?.?.?.jar -o server.jar
# Replace ?.?.? with the latest version

Initialize the server:

java -jar server.jar

config.example.yaml will be generated. Rename it to config.yaml and customize your settings.

Run as a Linux Service (Systemd): Create a file at /etc/systemd/system/your-server.service:

[Unit]
Description=My Server
After=network.target

[Service]
Type=simple
User=YOU
WorkingDirectory=/path/to/server
ExecStart=java -jar /path/to/server/server.jar # or path/to/jre/bin/java -jar /path/to/server/server.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target

Apply and start:

sudo systemctl daemon-reload
sudo systemctl enable your-server
sudo systemctl start your-server

Final Step

To access your server from outside your network, we recommend the following methods:

  • Tailscale
  • Cloudflare Tunnel
  • Ngrok
  • Custom Domain with HTTPS

WARNING: Ensure your configuration is secure according to your chosen method. Avoid risky methods like direct port forwarding.

Update

You can easily update the server by replacing the JAR file.

# Stop the Service (for Linux)
sudo systemctl stop your-server

# Rename the old server file
mv server.jar server-old.jar

# Download the latest version
curl -L https://github.com/amphi2024/server/releases/download/v?.?.?/server-?.?.?.jar -o server.jar

# Restart the Service
sudo systemctl restart your-server