Overview: Support thread for the kanboard docker template on Community Applications.

Dockerhub: https://hub.docker.com/r/kanboard/kanboard/

Documentation: https://docs.kanboard.org/en/latest/

Repository: https://github.com/kanboard/kanboard

 

This is the support thread for the kanboard docker template that can be found on Community Applications. Kanboard is project management software that focuses on the Kanban methodology.

 

Installation

To install the container, find it in the Community Applications on your Unraid server and click to install from there. The port is set to 8001 by default, but you should check if that is still free on your server and change it if necessary. The data and plugin directories are mapped to the appdata folder, which you probably don't need to change unless you have reason to do so. From there on you can click apply and start the container. The default username and password is admin and admin, which you should change in the settings right away.

 

 

Feel free to ask any questions or mention problems you're facing with the container in this thread.

In case anyone wants to be able to use the plugins right from the UI. you have to add the variable yourself. Like this.

On 4/3/2021 at 6:54 AM, cammelspit said:

In case anyone wants to be able to use the plugins right from the UI. you have to add the variable yourself. Like this.

Hey,

Another way to enable it would have been through the config file in the data folder, but I've added the option to set it when setting up the docker right away. Left it to false as default, since this is how the original config file has it set. Thanks for the heads-up!

So I have Kanboard running on another system that uses MySql but I see this installation option uses SQLite. I guess to migrate over I'd need to setup a MySQL docker and then somehow configure the Kanboard install to use MySql? Or is there an easier way or is that even possible?

In case you search for default user to login:

 

user: admin

pass: admin

 

I did not find this mentioned somewhere.
You can then change the password for the admin user in the user management:

 

Is there an easy way to enable SSL?

10 hours ago, Phredwerd said:

Is there an easy way to enable SSL?

I would recommend to use a reverse proxy for SSL, like the SWAG docker. Otherwise, you can map the volumes of your SSL certs to /etc/nginx/ssl.

where does it put the config file? I cannot seem to be able to get it to read one i created from the appdata/data folder and i found another one while looking directly in the container. However when i look for it in the normal terminal browser i cannot seem to find it...

Hello all,

 

Having an issue - having enabled plugins via the install, when I try and install a plugin through the webui (greenwing as an example), the following error pops up:

"Unable to open plugin archive."

 

a quick google suggests this is due to missing php-zip - any possible way to add this or am I doing something ridiculously silly?

 

Thanks in advance.

 

EDIT: plugins work if I wget them and unzip them to the plugins folder - would be good to have it working from UI though!

EDIT: if i manually add the variable as shown by Cammelspit, it works - bit random but sorted! Keeping this up for others incase they hit the same issue!

Edited March 16, 20233 yr by LewJ
Updated

This appears at the top of any page I'm on

Warning: filemtime(): stat failed for /var/www/app/assets/css/app.min.css in /var/www/app/app/Helper/AssetHelper.php on line 41

 

I tried clearing the sessions table, stopping and restarting the kanban app, docker itself and even re-installed kanban but that didn't seem to work so not sure what else can be done?

How do I set up email smtp?

I followed the instructons here but no luck so far.

2 hours ago, flowermoron said:

How do I set up email smtp?

I followed the instructons here but no luck so far.

You should be able to add the lines needed for smtp to in the config.php file. Since I had not mounted this to the appdata folder yet, I have updated the xml file now, but get the file mounted right now you should go to your docker page, left click the kanboard icon and select console. In there run the command "cp -u /var/www/app/config.php /var/www/app/data/config.php" without quotes. Then the config.php file should appear in your appdata/kanboard/data folder and you can add the lines needed for smtp there.

 

I am not currently using this docker anymore so I'm not sure about all the settings to get email work, but the guide on the kanboard website should be able to help you out.

2 hours ago, flowermoron said:

How do I set up email smtp?

I followed the instructons here but no luck so far.

You should be able to add the lines needed for smtp to in the config.php file. Since I had not mounted this to the appdata folder yet, I have updated the xml file now, but get the file mounted right now you should go to your docker page, left click the kanboard icon and select console. In there run the command "cp -u /var/www/app/config.php /var/www/app/data/config.php" without quotes. Then the config.php file should appear in your appdata/kanboard/data folder and you can add the lines needed for smtp there.

 

I am not currently using this docker anymore so I'm not sure about all the settings to get email work, but the guide on the kanboard website should be able to help you out.

Edited August 3, 20232 yr by ArieDed

Is there a way to revert the sub-task organization back to how it used to be as opposed to the way it's setup now with stacking?

 

I preferred it with the "X" moving icon, the drop down and the name of the task be all in the same line.

4 hours ago, Phredwerd said:

Is there a way to revert the sub-task organization back to how it used to be as opposed to the way it's setup now with stacking?

 

I preferred it with the "X" moving icon, the drop down and the name of the task be all in the same line.

For me the sub-task organization is still in the same line, maybe a force reload of the webpage could help or the theme you are using is causing the stacking?

13 hours ago, ArieDed said:

For me the sub-task organization is still in the same line, maybe a force reload of the webpage could help or the theme you are using is causing the stacking?

 

Ok it seems that the Nebula theme (installed via the Customizer plugin) was causing this issue as well as this error:
 

Warning: filemtime(): stat failed for /var/www/app/assets/css/app.min.css in /var/www/app/app/Helper/AssetHelper.php on line 41

 

Showing up at the top of any page you were on. I guess it must be outdated? Too bad. I liked that theme.

I'm not sure why, but I just installed and the defauly username/password of admin/admin does not work for me. 😅 has there been a update to this?
I did set it up to use it's own custom eth0 ip on the local network so it could use port 80. But I doubt that would have anything to do with it..

This is my log so far:
 

PHP message: Kanboard: user admin authentication failure with IP address: 192.168.1.56"
2024/10/03 10:39:27 [error] 16#16: *18 FastCGI sent in stderr: "PHP message: Kanboard: user admin authentication failure with IP address: 192.168.1.56" while reading response header from upstream, client: 192.168.1.56, server: localhost, request: "POST /?controller=AuthController&action=check HTTP/1.1", upstream: "fastcgi://unix:/var/run/php-fpm.sock:", host: "192.168.1.15"

 

On 10/3/2024 at 5:43 PM, StevenMDR said:

I'm not sure why, but I just installed and the defauly username/password of admin/admin does not work for me. 😅 has there been a update to this?
I did set it up to use it's own custom eth0 ip on the local network so it could use port 80. But I doubt that would have anything to do with it..

This is my log so far:
 

PHP message: Kanboard: user admin authentication failure with IP address: 192.168.1.56"
2024/10/03 10:39:27 [error] 16#16: *18 FastCGI sent in stderr: "PHP message: Kanboard: user admin authentication failure with IP address: 192.168.1.56" while reading response header from upstream, client: 192.168.1.56, server: localhost, request: "POST /?controller=AuthController&action=check HTTP/1.1", upstream: "fastcgi://unix:/var/run/php-fpm.sock:", host: "192.168.1.15"

 

Hi, I've just tried setting up a brand-new container and the default username and passwords have not changed. Maybe there is something else that you have changed? I would try setting up a new container without changing anything, just the port so it doesn't conflict with any other containers and see if the default login date work for that.

On 10/5/2024 at 3:47 PM, ArieDed said:

Hi, I've just tried setting up a brand-new container and the default username and passwords have not changed. Maybe there is something else that you have changed? I would try setting up a new container without changing anything, just the port so it doesn't conflict with any other containers and see if the default login date work for that.

Hey thanks for the help, I had zero luck with this.. 😅 I'm not sure why, only other thing I can really think of is that maybe there is an old data file for this container that never got cleaned up from a long time ago on my end. Regardless, I ended up testing/using a different task manager. 😂 Maybe I'll try this again in the future. 👍

Seems I forgot the admin password...

Not sure how to reset it using the Unraid Docker.

Is there an easy way to do this?

Does anyone have trouble changing the port when using Tailscale?

I cannot seem to change the port for the web server, and it will always use port 80.

docker run
  -d
  --name='kanboard'
  --entrypoint='/opt/unraid/tailscale'
  --net='br0'
  --pids-limit 2048
  -e TZ="America/Los_Angeles"
  -e HOST_OS="Unraid"
  -e HOST_HOSTNAME="Tower"
  -e HOST_CONTAINERNAME="kanboard"
  -e 'TCP_PORT_80'='8001'
  -e 'PUID'='99'
  -e 'PGID'='100'
  -e 'PLUGIN_INSTALLER'='true'
  -e 'CA_TS_FALLBACK_DIR'='/var/www/app/data'
  -e TAILSCALE_HOSTNAME='kanboard'
  -e TAILSCALE_ALLOW_LAN_ACCESS='false'
  -e TAILSCALE_USE_SSH='false'
  -e TAILSCALE_USERSPACE_NETWORKING='false'
  -e TAILSCALE_SERVE_PORT='8001'
  -e ORG_POSTARGS='cp
  -u /var/www/app/config.php /var/www/app/data/config.php'
  -e ORG_ENTRYPOINT="/usr/local/bin/entrypoint.sh"
  -l net.unraid.docker.managed=dockerman
  -l net.unraid.docker.webui='http://[IP]:[PORT:8001]'
  -l net.unraid.docker.icon='https://raw.githubusercontent.com/ArieDed/unraid-template/master/img/kanboard_logo.png'
  -l net.unraid.docker.tailscale.webui='https://[hostname][magicdns]'
  -l net.unraid.docker.tailscale.hostname='kanboard'
  -v '/mnt/user/appdata/kanboard/data':'/var/www/app/data':'rw'
  -v '/mnt/user/appdata/kanboard/plugins':'/var/www/app/plugins':'rw'
  -v '/usr/local/share/docker/tailscale_container_hook':'/opt/unraid/tailscale'
  --cap-add=NET_ADMIN
  --device='/dev/net/tun' 'kanboard/kanboard'

On 11/26/2025 at 11:06 PM, Jaybau said:

Does anyone have trouble changing the port when using Tailscale?

I cannot seem to change the port for the web server, and it will always use port 80.

docker run
  -d
  --name='kanboard'
  --entrypoint='/opt/unraid/tailscale'
  --net='br0'
  --pids-limit 2048
  -e TZ="America/Los_Angeles"
  -e HOST_OS="Unraid"
  -e HOST_HOSTNAME="Tower"
  -e HOST_CONTAINERNAME="kanboard"
  -e 'TCP_PORT_80'='8001'
  -e 'PUID'='99'
  -e 'PGID'='100'
  -e 'PLUGIN_INSTALLER'='true'
  -e 'CA_TS_FALLBACK_DIR'='/var/www/app/data'
  -e TAILSCALE_HOSTNAME='kanboard'
  -e TAILSCALE_ALLOW_LAN_ACCESS='false'
  -e TAILSCALE_USE_SSH='false'
  -e TAILSCALE_USERSPACE_NETWORKING='false'
  -e TAILSCALE_SERVE_PORT='8001'
  -e ORG_POSTARGS='cp
  -u /var/www/app/config.php /var/www/app/data/config.php'
  -e ORG_ENTRYPOINT="/usr/local/bin/entrypoint.sh"
  -l net.unraid.docker.managed=dockerman
  -l net.unraid.docker.webui='http://[IP]:[PORT:8001]'
  -l net.unraid.docker.icon='https://raw.githubusercontent.com/ArieDed/unraid-template/master/img/kanboard_logo.png'
  -l net.unraid.docker.tailscale.webui='https://[hostname][magicdns]'
  -l net.unraid.docker.tailscale.hostname='kanboard'
  -v '/mnt/user/appdata/kanboard/data':'/var/www/app/data':'rw'
  -v '/mnt/user/appdata/kanboard/plugins':'/var/www/app/plugins':'rw'
  -v '/usr/local/share/docker/tailscale_container_hook':'/opt/unraid/tailscale'
  --cap-add=NET_ADMIN
  --device='/dev/net/tun' 'kanboard/kanboard'

Sorry, I have no experience using Tailscale with Docker containters, so can't help you with that. It does seem weird that you do not have a -p for the port in the docker run command, normally this should be -p HOST_PORT:CONTAINER_PORT . Do you not have a port set? The TCP_PORT_80 Is just an environment variable.

Hi, trying to setup kanboard, all is OK, but I have no config file inside of root or Data or plugins. I simply created config.php inside of data, with SMTP configuration, but it seems that docker is not using is, because when debugging email flow, I cannot simply see any action there related to emailing. Can you advice?

Thanks

Vladimir