Summary: Support Thread for Headscale Docker

Application: Headscale

DockerHub: https://hub.docker.com/r/headscale/headscale

 

This template has been tested on a production machine using NPM as a proxy and only opening the port for connection.

 

If you find any errors with the template please post here so that I can fix them. If you need some support or guidance also write here.

 

If you find errors in the app itself then please contact the developer through their issues page: https://github.com/juanfont/headscale/issues

 

The proper steps for running this container is written under Overview. If you can't get it to work then double and triple check the config file which is usually the cause of the problems.

Edited November 11, 20241 yr by gxs

Hi,

 

Just starting to setup this but seem to have issues with the container, specifically if I try view logs or enter console, the popup window shows for a split second and then closes.

 

There is also no cpu/memory load showing.

 

config file is present, changing server_url and the base_url.

On 2/5/2025 at 8:02 AM, Toady001 said:

Hi,

 

Just starting to setup this but seem to have issues with the container, specifically if I try view logs or enter console, the popup window shows for a split second and then closes.

 

There is also no cpu/memory load showing.

 

config file is present, changing server_url and the base_url.

I am having the same issue. I keep getting a bad gateway error and when going to view logs or the console it just closes right away.

I am not sure what I am doing wrong. Everything else on NPM works flawlessly. This is the only thing I have not  been able to get to work.

On 2/28/2025 at 6:58 AM, barajas.uriel said:

I am having the same issue. I keep getting a bad gateway error and when going to view logs or the console it just closes right away.

I am not sure what I am doing wrong. Everything else on NPM works flawlessly. This is the only thing I have not  been able to get to work.

I ended up installing on a paid vps instead.

 

Problem I had is the log screen is not open long enough to see the errors and not sure how to go about looking for the log files (which I understand are in the docker.img file)

Sorry guys. It's fixed now. The problem was with the constantly changing config file on the latest version.

 

I have hardcoded the version now so that the changes don't constantly break things.

Edited April 24, 20251 yr by gxs

I just noticed that you hardcoded it to a older version, is there a plan to update it soon?

Headscale has been running fine for months, however recently I have been unable to access the console. When I open it, it closes immediately. I have tried on another machine with the same result (separate headscale instance). Headscale itself is running properly except I need command line access to generate new users...

I am also having this issue. In addition docker exec at the unraid cli generates an error that the shell command is not in $path. This happens when I specify sh, /bin/sh and /bin/bash

I solved this. I had a note that console access is only available through container versions with “-debug” at the end of the docker hub tag.

I think the latest such container repo is headscale/headscale:sha-171fd7a3-debug. I set that as my repository in the unraid template and console access is restored.

Note you also need to be sure you specify Shell and not Bash as the Console shell command in the unraid template if you want console access from the unraid gui.

Edited June 11Jun 11 by seanwalter