1- # Pterodactyl Development Environment
1+ [ ![ Logo Image] ( https://cdn.pterodactyl.io/logos/new/pterodactyl_logo.png )] ( https://pterodactyl.io )
2+
3+ # Pterodactyl Development
24This repository provides a ` docker-compose ` based environment for handling local development of Pterodactyl.
35
46** This is not meant for production use! This is a local development environment only.**
@@ -9,10 +11,9 @@ other than macOS, and I probably haven't documented most of the important bits.
911PRs or Issues as necessary to improve this environment.
1012
1113### Getting Started
12- You'll need the following things installed on your machine.
14+ You'll need the following dependencies installed on your machine.
1315
14- * [ Docker] ( https://docker.io )
15- * [ Mutagen Compose] ( https://github.com/mutagen-io/mutagen-compose )
16+ * [ Orbstack] ( https://orbstack.dev )
1617* [ mkcert] ( https://github.com/FiloSottile/mkcert )
1718
1819### Setup
@@ -32,14 +33,24 @@ cd development
3233* Minio Container for S3 emulation
3334
3435### Accessing the Environment
35- Once you've setup the environment, simply run ` ./beak up -d ` to start the environment. This simply aliases
36- some common Docker compose commands.
36+ Once you've setup the environment, simply run ` ./beak build ` and then ` ./beak up -d` to start the environment.
37+ ` beak ` aliases some common Docker compose commands, but everything else will pass through to ` docker compose ` .
3738
3839Once the environment is running, ` ./beak app ` and ` ./beak wings ` will allow SSH access to the Panel and
3940Wings environments respectively. Your Panel is accessible at ` https://pterodactyl.test ` . You'll need to
4041run through the normal setup process for the Panel if you do not have a database and environment setup
4142already. This can be done by SSH'ing into the Panel environment and running ` setup-pterodactyl ` .
4243
43- The code for the setup can be found in ` build/panel/setup-pterodactyl ` . Please note, this environment uses
44- Mutagen for file handling, so replace calls to ` docker compse up ` or ` down ` with ` mutagen-compose up ` or ` down ` .
45- All other ` docker compose ` commands can be used as normal.
44+ The code for the setup can be found in ` build/panel/setup-pterodactyl ` . Ensure you run ` yarn serve ` or
45+ ` yarn build ` before accessing the Panel. You can run ` yarn ` inside the container, or just in the ` code/panel `
46+ directory on your host machine, assuming you have ` node >= 22 ` .
47+
48+ ### Running Wings
49+ You'll need to create a location and a node in the Panel instance before you can configure Wings. Set up the
50+ node _ as being "Behind Proxy"_ and set the ` Daemon Port ` value to 443. Copy over the resulting ` config.yml `
51+ file to ` /home/root/wings/config.yml ` on the Wings dev container.
52+
53+ When you write that file, update the ` port ` value in the file to be ` 8080 ` since we're doing some proxying
54+ for the environment with Traefik.
55+
56+ You should then be able to run ` make debug ` which will start the Wings daemon in debug mode.
0 commit comments