VPS Setup

SunLicense Server Setup VPS Guide (Without Pterodactyl)

SunLicense VPS Setup Guide (Without Pterodactyl)

This guide will walk you through setting up SunLicense on a VPS without using Pterodactyl.

Prerequisites

Before starting, ensure your VPS meets the following requirements:

  • Java 21+ installed

  • A valid SunLicense license key

Installation Steps

1. Upload Required Files

Transfer the following files to your VPS:

  • server.jar (SunLicense server file)

  • license.txt (Contains your license key)

You can use scp or an FTP client like FileZilla to upload these files to your VPS.

Example using scp:

scp server.jar license.txt user@your-vps-ip:/home/user/

2. Start SunLicense Server

Navigate to the directory containing server.jar and license.txt, then execute the following command:

SERVER_PORT=25595 java -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar

  • Replace 25595 with the desired port number.

  • Ensure the port is open in your firewall settings.

If Java 21+ is not installed, you can install it using:

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

3. Verify Local Access

Once the server starts, you can access SunLicense from the VPS itself:

curl http://localhost:25595

Replace 25595 with your chosen port.

4. Expose to the Internet (Optional)

If you want to access SunLicense from an external network, you need to configure a reverse proxy using Nginx.

Install Nginx

sudo apt install nginx -y

Configure Nginx Proxy

Create a new Nginx configuration file:

sudo nano /etc/nginx/sites-available/sunlicense

Add the following content:

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:25595;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Save and exit (CTRL + X, then Y, then Enter).

Enable the Configuration

sudo ln -s /etc/nginx/sites-available/sunlicense /etc/nginx/sites-enabled/

Restart Nginx:

sudo systemctl restart nginx

Now, you can access SunLicense from http://yourdomain.com.

5. Running on Port 80 (Alternative)

If you don't want to use Nginx, you can run SunLicense directly on port 80:

SERVER_PORT=80 java -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar

Note: This works only if no other services (like Nginx or Apache) are using port 80.

6. Configure Firewall (If Required)

To allow external access, open the required ports:

sudo ufw allow 80/tcp
sudo ufw allow 25595/tcp
sudo ufw reload

7. Keeping SunLicense Running

To keep SunLicense running even after closing the terminal, use screen or tmux:

Using screen

sudo apt install screen -y
screen -S sunlicense
SERVER_PORT=25595 java -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar

Press CTRL + A, then D to detach. To resume, use:

screen -r sunlicense

Using tmux

sudo apt install tmux -y
tmux new -s sunlicense
SERVER_PORT=25595 java -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar

Detach with CTRL + B, then D. Resume with:

tmux attach -t sunlicense

Conclusion

SunLicense is now set up on your VPS without Pterodactyl. You can manage it manually or configure a systemd service for automatic startup. If you need a managed setup, consider SunLicense Managed Hosting.

For purchasing, visit: SunLicense on BuiltByBit.

PreviousQuickstartNextDashboard

Last updated