VPS Setup

SunLicense Server Setup VPS Guide (Without Pterodactyl)

Prerequisites

Java 21+ installed
A valid SunLicense license key. See Get your license key.

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. Example using scp:

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

2. Start the SunLicense server

Navigate to the directory containing server.jar and license.txt, then run:

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

Replace 25595 with the desired port number.
Make sure the port is open in your firewall settings.

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

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

3. Verify local access

Once the server starts, check it from the VPS itself:

curl http://localhost:25595

4. Expose to the internet (optional)

To access SunLicense from an external network, configure a reverse proxy with Nginx. Install Nginx

sudo apt install nginx -y

Configure the Nginx proxy

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 and restart Nginx

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

SunLicense is now available at http://yourdomain.com.

5. Run on port 80 (alternative)

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

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

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

6. Configure the firewall (if required)

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

7. Keep SunLicense running

To keep SunLicense running after you close the terminal, use screen or tmux:

screen
tmux

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:

screen -r sunlicense

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. You can manage it manually or configure a systemd service for automatic startup. If you’d prefer a managed setup, consider SunLicense Managed Hosting.

Getting Started

API Reference

Automations

Product Integrations

Operations

Prerequisites

1. Upload required files

2. Start the SunLicense server

3. Verify local access

4. Expose to the internet (optional)

5. Run on port 80 (alternative)

6. Configure the firewall (if required)

7. Keep SunLicense running

Conclusion

​Prerequisites

​1. Upload required files

​2. Start the SunLicense server

​3. Verify local access

​4. Expose to the internet (optional)

​5. Run on port 80 (alternative)

​6. Configure the firewall (if required)

​7. Keep SunLicense running

​Conclusion

Prerequisites

1. Upload required files

2. Start the SunLicense server

3. Verify local access

4. Expose to the internet (optional)

5. Run on port 80 (alternative)

6. Configure the firewall (if required)

7. Keep SunLicense running

Conclusion