Apache web server configuration guide

The configuration files in this directory have been tested with Apache version 2.4.7.

To set up kanban you first need to enable several additional apache modules:

  • proxy_wstunnel (to proxy web sockets)
  • proxy
  • proxy_http

Common issues

Internally Kanban uses GitLab API. So misconfiguration of the GitLab web server could lead to potential kanban malfunctions. Here you will find common issues we faced with GitLab + Apache setup and how to solve them.

  1. Boards are not showing up.

    The symptoms - you can login to kanban, you can see the projects list in kanban, but can not open any board.

    First of all check your GitLab apache config contains rewrite rules like this one:

    RewriteRule .*{REQUEST_URI} [P,QSA]

    Note the flags [P,QSA] - these are not enough for GitLab API to work properly, there must be NE flag present, so the proper rule is:

    RewriteRule .*{REQUEST_URI} [NE,P,QSA]

    Also, please check the gitlab recipes repo for the latest apache configs.

  2. Kanban reloads in a loop.

    The symptoms - you can login to kanban, but then the browser keep reloading the page.

    This could be caused by websockets proxy misconfiguration. Kanban listens for websocket connections on /ws/ location, so it should be proxied properly and there must be Host, Connection and Upgrade headers present.

  3. Config example

    <VirtualHost *:80>
        ProxyPreserveHost On
        <Location />
        <Location /ws/>
            ProxyPass ws://
            ProxyPassReverse ws://

    view on github