brmlab/brmkan
9
0
Fork 0
mirror of https://github.com/brmlab/brmkan.git synced 2025-10-29 07:24:02 +01:00
Code Issues Projects Releases Packages Wiki Activity
Wekan for brmlab
48 commits 3 branches 0 tags 66 KiB
Find a file
Exact
Malanius 2e993e86ed Update test branch in readme
2018-09-09 13:57:48 +02:00
nginx Add nginx configuration for brmkan-test 2018-09-09 13:50:54 +02:00
docker-compose.yml Add docker-compose for brmkan-test 2018-09-09 13:53:21 +02:00
LICENSE License to year 2018 2018-02-12 21:12:16 +02:00
README.md Update test branch in readme 2018-09-09 13:57:48 +02:00

README.md

brmkan

Test

Test instace is currently running on AWS EC2 instance: https://brmkan.malanius.net/ managed by malanius. Content of this branch reflects that instance and it's settings.

Useful links

Install

  1. Install docker-compose.
  2. Clone this repo: 
    git clone https://github.com/brmlab/brmkan.git
cd brmkan
  3. Checkout brmkan-test branch: 
    git checkout brmkan
  4. Generate letsencrypt certificate with certbot.
  5. Generate SSL dhparam 
    sudo openssl dhparam -out /etc/ssl/dh_param.pem 2048
  6. Copy nginx configuration files.
  7. Create a dedicated user for Wekan, for example: 
    sudo useradd -d /home/wekan -m -s /bin/bash wekan
  8. Add this user to the docker group: 
    sudo usermod -aG docker wekan
  9. Switch login as user wekan: 
    sudo su - wekan
  10. Copy docker-compose.yml file to /home/wekan/docker-compose.yml
  11. Modify the ROOT_URL and MAIL_* parameters as required.
  12. Run in detached mode: 
    docker-compose up -d

Maitenance

Check the logs

docker ps
docker logs CONTAINER-ID-OF-Wekan-or-MongoDB-HERE

Data save/restore

Upgrading wekan

  1. Always backup the db before upgrading (see above)!
  2. In brmkan directory, stop the running services: 
    docker-compose stop
  3. Remove wekan container: 
    docker-compose rm wekan
  4. Update the wekan image 
    docker-compose pull wekan
  5. Start it again: 
    docker-compose up -d

Upgrading MonmgoDB

  1. Always backup the db before upgrading (see above)!
  2. In brmkan directory, stop the running services: 
    docker-compose stop
  3. Remove wekan container: 
    docker-compose rm wekandb
  4. Update the MongoDB image 
    docker-compose pull wekandb
  5. Start it again: 
    docker-compose up -d
  6. Restore the data from created backup