Note
This version of Heliactyl 14 is built to be clean, fast and stable. It lacks highly specific features such as Linkvertise and Stripe billing but retains all of the functionality of previous Heliactyl releases (v11, v12, v13).
Warning
Heliactyl 14 is not compatible with settings.json files from v13 or earlier. You can keep the same database.sqlite though without having any issues.
Heliactyl is a high-performance client area for the Pterodactyl Panel. It allows your users to create, edit and delete servers, and also earn coins which can be used to upgrade their servers.
You can get started straight away by following these steps:
- Clone the repo: Run
git clone https://github.com/heliactyloss/heliactylon your machine - Enter the directory and configure the
settings.jsonfile - most are optional except the Pterodactyl and OAuth2 settings which must be configured - Check everything out and make sure you've configured Heliactyl correctly
- Create SSL certificates for your target domain and set up the NGINX reverse proxy
Here's a proxy config that we recommend, however you are free to change it:
server {
listen 80;
server_name <domain>;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
location /ws {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_pass "http://localhost:<port>/ws";
}
server_name <domain>;
ssl_certificate /etc/letsencrypt/live/<domain>/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/<domain>/privkey.pem;
ssl_session_cache shared:SSL:10m;
ssl_protocols SSLv3 TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
location / {
proxy_pass http://localhost:<port>/;
proxy_buffering off;
proxy_set_header X-Real-IP $remote_addr;
}
}These commands are available:
npm run start - starts Heliactyl via nodemon
npm run build - builds TailwindCSS, required for making changes to the UI
In v14, we've introduced the next generation of Heliactyl's API. You can see the documentation below:
Method: GET
Query Parameters:
- id (string): The user's ID
Response:
- status (string): "success" or an error message
- package (object): The user's package details
- extra (object): The user's additional resources
- userinfo (object): The user's information from the Pterodactyl panel
- coins (number | null): The user's coin balance (if coins is enabled)
Method: POST
Request Body:
- id (string): The user's ID
- coins (number): The number of coins to set
Response:
- status (string): "success" or an error message
Method: POST
Request Body:
- id (string): The user's ID
- package (string, optional): The package name (if not provided, the user's package will be removed)
Response:
- status (string): "success" or an error message
Method: POST
Request Body:
- id (string): The user's ID
- ram (number): The amount of RAM to set
- disk (number): The amount of disk space to set
- cpu (number): The amount of CPU to set
- servers (number): The number of servers to set
Response:
- status (string): "success" or an error message