public/geek-cookbook
1
0
Fork 0
mirror of https://github.com/funkypenguin/geek-cookbook/ synced 2025-12-14 18:26:28 +00:00
Code Issues Releases Wiki Activity

Polish Kanboard

Browse Source
This commit is contained in:
David Young
2018-06-11 20:27:53 +12:00
parent e27e32e8b1
commit 20917da404
1 changed files with 37 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
manuscript/recipies/kanboard.md
View File

@@ -2,7 +2,10 @@ hero: Kanboard - A recipe to get your personal kanban on
# Kanboard # Kanboard
Kanboard is a Kanban tool, developed by [Frédéric Guillot](https://github.com/fguillot). (Who also happens to be the developer of my favorite RSS reader, [Miniflux](/recipies/miniflux/)) Kanboard is a Kanban tool, developed by [Frédéric Guillot](https://github.com/fguillot). (_Who also happens to be the developer of my favorite RSS reader, [Miniflux](/recipies/miniflux/)_)
!!! tip "Sponsored Project"
Kanboard is one of my [sponsored projects](/sponsored-projects/) - a project I financially support on a regular basis because of its utility to me. I use it both in my DayJob(tm), and to manage my overflowing, overly-optimistic personal commitments! 😓
Features include: Features include:
@@ -36,6 +39,16 @@ Create the location for the bind-mount of the application data, so that it's per
mkdir -p /var/data/kanboard mkdir -p /var/data/kanboard
``` ```
### Setup Environment
If you intend to use an [OAuth proxy](/reference/oauth_proxy/) to further secure public access to your instance, create a ```kanboard.env``` file to hold your environment variables, and populate with your OAuth provider's details (_the cookie secret you can just make up_):
```
# If you decide to protect kanboard with an oauth_proxy, complete these
OAUTH2_PROXY_CLIENT_ID=
OAUTH2_PROXY_CLIENT_SECRET=
OAUTH2_PROXY_COOKIE_SECRET=
```
### Setup Docker Swarm ### Setup Docker Swarm
@@ -55,32 +68,34 @@ services:
- /var/data/kanboard/data:/var/www/app/data - /var/data/kanboard/data:/var/www/app/data
- /var/data/kanboard/plugins:/var/www/app/plugins - /var/data/kanboard/plugins:/var/www/app/plugins
networks: networks:
- traefik_public - internal
deploy: deploy:
labels: labels:
- traefik.frontend.rule=Host:kanboard.example.com - traefik.frontend.rule=Host:kanboard.example.com
- traefik.docker.network=traefik_public - traefik.docker.network=traefik_public
- traefik.port=80 - traefik.port=80
cron: proxy:
image: kanboard/kanboard image: zappi/oauth2_proxy
volumes: env_file : /var/data/config/kanboard/kanboard.env
- /var/data/kanboard/data:/var/www/app/data
user: nginx
networks: networks:
- internal - internal
entrypoint: | - traefik_public
bash -c 'bash -s <<EOF deploy:
trap "break;exit" SIGHUP SIGINT SIGTERM labels:
while [ ! -f /var/www/app/config.php ]; do - traefik.frontend.rule=Host:kanboard.example.com
sleep 1 - traefik.docker.network=traefik_public
done - traefik.port=4180
while true; do volumes:
cd /var/www/app - /var/data/config/kanboard/authenticated-emails.txt:/authenticated-emails.txt
./cli cron command: |
sleep 8h -cookie-secure=false
done -upstream=http://app
EOF' -redirect-url=https://kanboard.example.com
-http-address=http://0.0.0.0:4180
-email-domain=example.com
-provider=github
-authenticated-emails-file=/authenticated-emails.txt
networks: networks:
traefik_public: traefik_public:
@@ -99,7 +114,7 @@ networks:
Launch the Kanboard stack by running ```docker stack deploy kanboard -c <path -to-docker-compose.yml>``` Launch the Kanboard stack by running ```docker stack deploy kanboard -c <path -to-docker-compose.yml>```
Log into your new instance at https://**YOUR-FQDN**. Default credentials are admin/admin, after which you can change (under 'profile') and add more users. Log into your new instance at https://**YOUR-FQDN**. Default credentials are admin/admin, after which you can change (_under 'profile'_) and add more users.
## Chef's Notes ## Chef's Notes