# VPS Setup

{% embed url="<https://youtu.be/objpAGzFlgM?t=219>" fullWidth="true" %}
SunLicense Server Setup VPS Guide (Without Pterodactyl)
{% endembed %}

## 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`:

```sh
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:

```sh
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:

```sh
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:

```sh
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**

```sh
sudo apt install nginx -y
```

**Configure Nginx Proxy**

Create a new Nginx configuration file:

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

Add the following content:

```nginx
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**

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

Restart Nginx:

```sh
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:

```sh
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:

```sh
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`**

```sh
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:

```sh
screen -r sunlicense
```

**Using `tmux`**

```sh
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:

```sh
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](https://docs.sunlicense.hapangama.com/services/managed-hosting).

For purchasing, visit: [SunLicense on BuiltByBit](https://builtbybit.com/resources/sunlicense-license-management-system.58359/).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sunlicense.hapangama.com/getting-started/vps-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.