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

• wekan-mongo in AWS
• wekan-mongo repository
• example nginx conf
• letsencrypt certbot
• test SSL configuratioon

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

• Backup all data from MongoDB
• Restore MongoDB data

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