leso-kn/kanban

Lean project management for GitLab

GitLab issues made awesome

Instant project management for your GitLab repositories

---

Notes about this fork

Hey there!

This fork has been slightly adjusted by @tmanick01 and me @Leso_KN to work with the latest version of gitlab.

(state: late 2018)

Propper way to get this working

1. Go ahead and clone the repository. Recurse is not required
2. Run make dev

at this point, a docker container named kb_dev should be running, but it's configured with the default settings.

To change the settings i recommend creating a script file in the projects root that looks like the following:

#!/bin/bash
export KANBAN_SERVER_HOSTNAME=http(s)://[DESIRED_KANBAN_HOST_URL]
export KANBAN_SECURITY_SECRET=qwerty
export KANBAN_GITLAB_URL=http(s)://[YOUR_GITLAB_URL]
export KANBAN_GITLAB_CLIENT=[YOUR_CLIENT]
export KANBAN_GITLAB_SECRET=[YOUR_SECRET]
export KANBAN_ENABLE_SIGNUP=false
export KANBAN_REDIS_ADDR=redis:6379

make dev

This way, you can apply changes to kanban board's source and run it directly using your custom settings.

I hope everything works for you. For additional assistance you can visit the near-dead gitter channel linked above. I receive email notifications of this and will usually answer. Enjoy!

---

Installation

Minimum Install Requrements:
OS: kernel minimum 3.10 (centOS 7, Ubuntu 14.04)
Packages: git, curl

sudo yum -y install git, curl

The easiest way to deploy Leanlabs Kanban board is to use docker-compose. Install instructions here. Assuming you have installed Docker and docker-compose.

1. Installation with Docker

git clone https://gitlab.com/leanlabsio/kanban.git

git clone https://github.com/leso-kn/kanban

cd kanban

1.1 Register GitLab Application for OAuth to work

Go to https://gitlab.com/profile/applications or your GitLab installation and register your application to get the application client ID and client secret key required for OAuth.

Where

Redirect url http[s]://{KANBAN_SERVER_HOSTNAME}/assets/html/user/views/oauth.html

1.2 Change default environment variables defined in docker-compose.yml

Where

KANBAN_SERVER_HOSTNAME | http[s]://{KANBAN_SERVER_HOSTNAME} - URL on which LeanLabs Kanban will be reachable [same as redirect url with out /assets/html...], required

KANBAN_SECURITY_SECRET | Change this string to antyhing you like. This string is used to generate user auth tokens

KANBAN_GITLAB_URL | http[s]://{gitlab.example.com:port} - Your GitLab host URL, required

KANBAN_GITLAB_CLIENT | Your GitLab OAuth client application ID, required for OAuth to work. Git this from your gitlab server.

KANBAN_GITLAB_SECRET | Your GitLab OAuth client secret key, required for OAuth to work. Git this from your gitlab server.

KANBAN_ENABLE_SIGNUP | Wheter to enable sign up with user API token.

Then

docker-compose up -d

Upgrading

If you followed instructions from "Installation with Docker", then the easiest way to upgrade would be:

git pull

docker-compose up -d

Changelog

You can view the changelog here

FAQ

1. How to install Kanban.Leanlabs
2. How to customize column