headplane: v5.7 Docker Container Not starting.

Description

Update to 5.7 on docker causes the container not to start with the following log. 5.6 running perfectly.

headplane | (node:1) ExperimentalWarning: SQLite is an experimental feature and might change at any time headplane | (Use node --trace-warnings ... to show where the warning was created) headplane | 2025-04-03T11:46:25.834Z [server] INFO: Running Node.js 22.14.0 headplane | 2025-04-03T11:46:25.835Z [config] INFO: Found a valid configuration file at /etc/headplane/config.yaml headplane | 2025-04-03T11:46:25.855Z [config] INFO: Found a valid Headscale configuration file at /etc/headscale/config.yaml headplane | 2025-04-03T11:46:25.866Z [config] INFO: User database file not accessible at /var/lib/headplane/users.json

Headplane Version

5.7

Headscale Version

25.1

About this issue

  • Original URL
  • State: closed
  • Created 2 years ago
  • Comments: 19 (6 by maintainers)

Most upvoted comments

Going forward I want to prevent breaking changes as they cause headaches for me and for everyone else. Especially when I have to play whack-a-mole with random issues that crop up right after cutting a release.

Unfortunately a lot of the changes recently are because Headscale itself made a breaking change for how OIDC authentication works. Headplane itself is fairly complex now, since it needs to handle the old user system, the new user system, and overriding it all with API key only login.

I think to try and ease the pain a little bit, I’m going to follow a stricter schedule on updates, pushing things to a next tag in Docker so that people can test things early and find issues before I cut new releases. As for the breaking changes, hopefully those are over now and I’ll use the GitHub releases feature so that people get notifications.

I’m going to cut an 0.5.9 release before enacting these changes, but this is entirely a transient upgrade, and will not break any functionality, just a few of those pesky whack-a-mole issues I mentioned earlier.

cc @phil3741 @RJDavison @Lukas10999 @buildplan. Changes for testing are starting now, including developing the next release in the next tag on Docker and Git.

0.6 PR: https://github.com/tale/headplane/pull/175 If you are interested in subscribing to future updates about pre-release testing: https://github.com/tale/headplane/discussions/176

thank you for the fix - I find it incredibly hard to follow this project because there often are breaking changes where I cannot find anything in the changelog. Since it doesnt use GitHubs release tags, you never get notified and only see every other week when manually checking in that something new is happening on the repo

Oh, then I suppose I should use the GitHub releases feature. But also, pin your container versions!