[BUG] Tried self-hosting with Docker on a VPS and hit multiple issues.

[thelite0]

Bug Description

Environment

• Ubuntu VPS
• Docker Compose
• Fresh clone of the repository

Issues encountered during self-hosting

1. pnpm / Corepack version mismatch

During the Docker build, Corepack downloaded pnpm 11.x while the image was using Node 20.

This resulted in installation failure due to unsupported Node.js features.

Workaround

Pinning pnpm to a compatible version (for example, pnpm 10.x) resolved the issue.

---

2. Interactive pnpm approve-builds

The Docker build stopped with:

ERR_PNPM_IGNORED_BUILDS
Run "pnpm approve-builds"

This is difficult to use in automated Docker builds because it requires interactive approval.

---

3. Missing native build dependencies

After allowing build scripts, installation failed because native packages required Python and native build tools.

Installing the following packages resolved the issue:

• python3
• make
• g++

---

4. GitHub OAuth debugging

GitHub authentication redirected back with error=github, but the logs did not indicate the underlying reason.

More detailed logging during provider initialization would make self-hosting troubleshooting significantly easier.

Steps to Reproduce

1. Clone the repository.
2. Follow the self-hosting/Docker setup instructions from the README.
3. Run docker compose up --build (or the documented startup command).
4. Observe the build process.

Depending on the environment, the build may fail with:

• Corepack/pnpm version mismatch.
• ERR_PNPM_IGNORED_BUILDS.
• Missing native build dependencies (python3, make, g++).

Affected Area

Other

Screenshots

No response

Browser & OS

No response

Environment

None

Additional Context

No response

[github-actions]

Thanks for opening your first issue on DevTrack! 🎉

A maintainer will take a look shortly. In the meantime:

• Check the Contributing guide if you are planning to work on this
• Browse Discussions for Q&A and ideas
• Look for good first issue if you want somewhere to start

If you find DevTrack useful, a ⭐ star on the repo is always appreciated — it helps the project reach more developers!