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
cd wekan
git submodule update --init --remote
(cd src; npm install)
docker-compose up --build -d
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:3000/
, 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.