Skip to content

Broken admin panel#74

Merged
EdGeraghty merged 13 commits intodevelopfrom
broken-admin-panel
Feb 25, 2026
Merged

Broken admin panel#74
EdGeraghty merged 13 commits intodevelopfrom
broken-admin-panel

Conversation

@EdGeraghty
Copy link
Member

@EdGeraghty EdGeraghty commented Feb 25, 2026

This pull request transitions the Headscale Admin GUI from using a prebuilt Docker image to building from source using a maintained fork (serein-213/headscale-admin-il18n), addresses the deprecation of the original GoodiesHQ/headscale-admin project, and upgrades Headscale from v0.27.1 to v0.28.0. The changes enable continued compatibility with newer Headscale releases whilst the project evaluates long-term admin panel alternatives.

Changes:

  • Switched Headscale-Admin from prebuilt image to source-based build using a forked repository
  • Updated Headscale from v0.27.1 to v0.28.0 with corresponding SHA256 checksum
  • Added deprecation notice warning users about the temporary nature of the current admin panel solution

This is a fork focussed on i18n, but has bug fixes for new logic paths. Unless upstream resurrects the project, the current admin panel is deprecated and planned to be replaced before headscale `0.29.X`
@github-actions

This comment was marked as outdated.

@github-actions
Copy link

🆕 New Headscale Config Options

+ taildrop
+ v4
+ v6```

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request migrates the Headscale-Admin GUI from using a deprecated pre-built Docker image to building from source using a community fork (serein-213/headscale-admin-il18n). The change addresses the upstream project's abandonment but introduces several critical security and build reliability concerns.

Changes:

  • Switched from pre-built goodieshq/headscale-admin:0.26.0 image to building from source using a forked repository
  • Updated documentation to reflect the new fork and added deprecation warning about future replacement
  • Modified Dockerfile to include Node.js build stage with npm build process

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

File Description
README.md Updated version table and links to point to new fork; added deprecation notice warning of future replacement
Dockerfile Replaced pre-built image with multi-stage build from source; added new ARG variables for repo URL, branch, and Node version; implemented git clone and npm build process

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions
Copy link

🆕 New Headscale Config Options

+ taildrop
+ v4
+ v6```

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

WORKDIR /app

ENV ENDPOINT="${HEADSCALE_ADMIN_ENDPOINT}"
RUN npm install && npm run build;
Copy link

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Using 'npm install' without '--production' or 'npm ci' may install development dependencies unnecessarily, increasing image size and attack surface. For Docker builds, 'npm ci --production' is preferred as it ensures reproducible builds and only installs production dependencies.

Suggested change
RUN npm install && npm run build;
RUN npm ci --omit=dev && npm run build;

Copilot uses AI. Check for mistakes.
Comment on lines +54 to +56
RUN git clone ${HEADSCALE_ADMIN_REPO} /app && \
cd /app && \
git checkout ${HEADSCALE_ADMIN_VERSION}
Copy link

Copilot AI Feb 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The git clone operation does not verify commit signatures or repository authenticity. Consider adding 'git config --global transfer.fsckObjects true' before cloning to enable additional safety checks, especially since you're building from an untagged commit from a third-party repository.

Copilot uses AI. Check for mistakes.
@github-actions
Copy link

🆕 New Headscale Config Options

+ v4
+ v6```

@EdGeraghty EdGeraghty merged commit 2d63389 into develop Feb 25, 2026
7 checks passed
@EdGeraghty EdGeraghty deleted the broken-admin-panel branch February 25, 2026 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants