GitHunt
BE

bentiss/wekan-dev

Docker environment for Wekan development

Wekan Development Environment

This is a containerised development environment for Wekan. It's meant to quickly
get you set up with a system that you can use to develop Wekan, without needing to worry about its
various dependencies.

To get started, you'll need Docker set up on your system.
Then:

git clone https://github.com/wekan/wekan-dev.git wekan-dev
cd wekan-dev
git submodule update --init --remote
./build.sh
./run.sh

This will take some time to build the image, and to initially cache & build the meteor packages.
Eventually you should be able to see Wekan at http://localhost:8081/, and changes made under
src/ will automatically trigger a refresh of the interface. Note that the src/ directory also
includes docker configuration; those are for the production builds of Wekan.

To update the Wekan source submodule to the head of its devel branch, you can use
git submodule update --remote; the commit reference stored in this repo will undoubtedly lag
behind the HEAD of that branch, hence its
inclusion even above.

For a continuous view of what's happening with the app, you can use docker-compose logs -f. To
start and stop the app, it's just docker-compose start and docker-compose stop. See the
docker-compose documentation for more commands.

With this setup, on my 2015 MacBook Pro, building the environment takes 40 seconds or so, and a
refresh after changes about 10 seconds. The initial build feels interminable, but is probably about
10-15 minutes. Changes to the packages or other stuff under src/.meteor/ will trigger a partial
re-build of the image, which will take a few minutes depending on your network connection.

Contributors

MIT License
Created May 14, 2019
Updated May 14, 2019