Skip to content

Commit 24da65a

Browse files
authored
Update README (#23)
1 parent 987e310 commit 24da65a

File tree

2 files changed

+20
-11
lines changed

2 files changed

+20
-11
lines changed

README.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
# Pterodactyl Development Environment
1+
[![Logo Image](https://cdn.pterodactyl.io/logos/new/pterodactyl_logo.png)](https://pterodactyl.io)
2+
3+
# Pterodactyl Development
24
This 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.
911
PRs 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

3839
Once the environment is running, `./beak app` and `./beak wings` will allow SSH access to the Panel and
3940
Wings environments respectively. Your Panel is accessible at `https://pterodactyl.test`. You'll need to
4041
run through the normal setup process for the Panel if you do not have a database and environment setup
4142
already. 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.

docker-compose.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@ services:
1919
- ./docker/certificates:/etc/certs:ro
2020
- /var/run/docker.sock:/var/run/docker.sock:ro
2121
app:
22-
# image: ghcr.io/pterodactyl/development/panel:latest
2322
build:
2423
dockerfile: ./build/panel/Dockerfile
2524
stop_grace_period: '1s'
@@ -38,7 +37,6 @@ services:
3837
WWWUSER: ${WWWUSER:-$$(id -u)}
3938
WWWGROUP: ${WWWGROUP:-$$(id -g)}
4039
wings:
41-
# image: ghcr.io/pterodactyl/development/wings:latest
4240
build:
4341
dockerfile: ./build/wings/Dockerfile
4442
stop_grace_period: '1s'

0 commit comments

Comments
 (0)