Warning
Using fixed-heliactyl or heliactyl in general is risky, there are lots of bugs and loopholes. Please migrate to fixed-palladium or to another client that doesn't use heliactyl as a base.
WARNING
Fixed Heliactyl 12.8 and above are not compatible with older files (themes) due to major settings modifications. Replace allsettings.api.client
withsettings
. Thank you for understanding.
WARNING
Fixed Heliactyl 12.7.10 and above is not compatible with Heliactyl's settings due to the switch to YAML, which is easier to use than JSON. You will need to reconfigure all of your settings.
- Resource Management: Create servers, manage resources.
- Coins: Earn through AFK pages, Linkvertise.
- Renewal: Use coins for server renewal.
- Coupons: Distribute resources and coins.
- Servers: Create, view, and edit servers.
- Payments: Stripe integration for purchases.
- Login Queue: Prevent overload with a queue system.
- User System: Authentication, password regeneration, etc.
- Store: Purchase resources with coins.
- Dashboard: Overview of resources.
- Join for Rewards: Earn coins by joining Discord servers.
- Admin Panel: Manage coins, resources, coupons.
- API: For bots and other integrations.
- Upload File: Upload the Heliactyl file to a Pterodactyl NodeJS server. Download the egg from Parkervcp's GitHub Repository
- Setup NodeJS: Unarchive the file and set the server to use NodeJS 16.
- Install Node.js 16 or newer it's recommended to install it with nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
- reopen a new ssh session (e.g., restart putty)
nvm install 16
- check the node version with
node -v
and switch between versions withnvm use <version>
- Download heliactyl files in /var/www/heliactyl:
git clone https://github.com/OvernodeProjets/Fixed-Heliactyl.git /var/www/heliactyl
- Installing required node modules (and build dependencies to avoid errors):
apt-get update && apt-get install libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev build-essential
cd /var/www/heliactyl && npm i
After configuring settings.json, to start the server, use node index.js
To run in the background, use PM2 (see PM2 section)
-
Rename exemple_settings.json to settings.json and configure settings.json (specify panel domain/apikey and discord auth settings for it to work)
-
Start the server (Ignore the 2 strange errors that might come up)
-
Login to your DNS manager, point the domain you want your dashboard to be hosted on to your VPS IP address. (Example: dashboard.domain.com 192.168.0.1)
-
Run
apt install nginx && apt install certbot
on the vps -
Run
ufw allow 80
andufw allow 443
on the vps -
Run
certbot certonly -d <Your Heliactyl Domain>
then do 1 and put your email -
Run
nano /etc/nginx/sites-enabled/heliactyl.conf
-
Paste the configuration at the bottom of this and replace with the IP of the pterodactyl server including the port and with the domain you want your dashboard to be hosted on.
-
Run
systemctl restart nginx
and try open your domain.
server {
listen 80;
listen [::]:80;
listen 443 ssl http2;
listen [::]:443 ssl http2;
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 TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers on;
ssl_ciphers 'HIGH:!aNULL:!MD5:!ECDHE-RSA-AES128-SHA';
if ($scheme = http) {
return 301 https://$server_name$request_uri;
}
location /afk/ws {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_pass http://localhost:<port>/afk/ws;
}
location / {
proxy_pass http://localhost:<port>/;
proxy_buffering off;
proxy_set_header X-Real-IP $remote_addr;
}
}
- Store certain things such as your api keys, discord auth settings, etc in a .txt file
- Download database.sqlite
- Delete all files off the server (or delete and remake the folder if done in ssh)
- Upload the latest Heliactyl v12 release and unzip it
- Upload database.sqlite and reconfigure settings.yml
- Delete everything except settings.yml, database.sqlite
- Put the files that you didn't delete into a zip file
- Upload the latest Heliactyl v12 release and unzip it
- Upload database.sqlite and reconfigure settings.yml
Installing pm2:
- Run
npm install pm2 -g
on the server
- Change directory to your Heliactyl folder Using
cd
command, Example:cd /var/www/heliactyl
- To run Heliactyl, use
pm2 start index.js --name "heliactyl"
- To view logs, run
pm2 logs Heliactyl
- Make sure your dashboard is running in the background with the help of pm2
- You can check if Heliactyl is running in the background with
pm2 list
- Once you confirm that Heliactyl is running in the background, you can create a startup script by running
pm2 startup
andpm2 save
- Note: Supported init systems are
systemd
,upstart
,launchd
,rc.d
- To stop your Heliactyl from running in the background, use
pm2 unstartup
To stop a currently running Heliactyl instance, use pm2 stop heliactyl
I'd rather tell you the code I've taken back or taken so as not to have drama or anything x)
- Dashactyl 0.3.1 & 0.4 (0.3.1 : Base | 0.4 : database system)
- Heliactyl v12.7 & v14 (v12.7 : Base | v14 : documentation api)
- BetterHeliactyl v15 (AFK system but i remade this)
- Faliactyl (YML / ReadSettings system)
- HolaClient (Linkvertise settings)
Warning
We cannot force you to keep "Powered by Heliactyl" in the footer, but please consider keeping it. It helps to get more visibility for the project, which is getting better. We won't > provide technical support for installations without the notice in the footer. We may DMCA the website under certain conditions. Please do keep the footer, though.
Caution
Heliactyl v6, v7, v8, v9, v10, v11, v13, v15 is now deprecated by the official Heliactyl team. Users have made forks of older Heliactyl version but the Heliactyl team will not give support. Please update to Heliactyl v12 or use Heliactyl v14.