# Avorion Pterodactyl Compatibility Image

This is a thin wrapper image for the Avorion egg that keeps behavior as close as possible to the original `ghcr.io/ptero-eggs/steamcmd:debian` image while fixing Avorion's `getpwuid(getuid()) returned NULL` startup failure.

## What this fixes

Avorion expects the current runtime UID inside the container to resolve to a valid user entry with a home directory. On some Pterodactyl setups, the server process runs as a UID that does not exist in `/etc/passwd` inside the image. When that happens, Avorion can crash on startup with:

- `Error finding home directory: getpwuid(getuid()) returned NULL`
- `Could not find a suitable directory for saving files`

This image adds a temporary passwd/group entry at startup using `libnss-wrapper`, while keeping the rest of the egg behavior nearly unchanged.

## Build and publish

Replace `YOUR_GHCR_USER` with your GitHub Container Registry namespace.

```bash
docker build -t ghcr.io/YOUR_GHCR_USER/avorion-steamcmd-nsswrap:latest .
docker push ghcr.io/YOUR_GHCR_USER/avorion-steamcmd-nsswrap:latest
```

## Egg changes

In your Avorion egg JSON, change only the Docker image entry.

From:

```json
"docker_images": {
  "ghcr.io/ptero-eggs/steamcmd:debian": "ghcr.io/ptero-eggs/steamcmd:debian"
}
```

To something like:

```json
"docker_images": {
  "ghcr.io/YOUR_GHCR_USER/avorion-steamcmd-nsswrap:latest": "ghcr.io/YOUR_GHCR_USER/avorion-steamcmd-nsswrap:latest"
}
```

You can leave the install script alone for the first test.

## Recommended startup command

Start with the most conservative startup possible so you are only testing the image fix:

```bash
export HOME=/home/container; mkdir -p "/home/container/galaxy/{{GALAXY_NAME}}/moddata/ConfigLib"; exec ./bin/AvorionServer --galaxy-name "{{GALAXY_NAME}}" --admin "{{ADMIN_ID}}" --datapath galaxy --port "{{SERVER_PORT}}" --query-port "{{QUERY_PORT}}" --steam-master-port "{{STEAM_MASTER_PORT}}" --steam-query-port "{{STEAM_QUERY_PORT}}" --max-players "{{MAX_PLAYERS}}" --difficulty "{{DIFFICULTY}}" --collision-damage "{{COLLISION_DMG}}" --save-interval "{{SAVE_INTERVAL}}" --same-start-sector "{{SAME_START_SECTOR}}" --server-name "{{SERVER_NAME}}" --threads "{{GAME_THREADS}}" --listed "{{SERVER_LISTED}}"
```

## Suggested rollout steps

1. Add `Dockerfile` and `entrypoint.sh` to a new Git repo.
2. Build and push the image to GHCR.
3. Update only the egg's Docker image reference.
4. Leave the install script unchanged.
5. Use the conservative startup command above.
6. Reinstall or rebuild the server container if needed so it pulls the new image.
7. Start the server and confirm the Avorion home-directory error is gone.
8. Only after it boots cleanly, revisit `--datapath`, symlinks, or mod path adjustments.