wekan/README.md
Lauri Ojansivu ac196c89c4 Fix typo.
2017-04-02 15:17:46 +03:00

9.5 KiB
Raw Permalink Blame History

Wekan

Wekan Build Status

Wekan chat

2017-02-08 News: All of Wefork is now merged and moved back to official Wekan. Wefork will not accept any new issues and pull requests. All development happens on Wekan.

Wefork announcement and merging back

Wefork FAQ

Translate Wekan at Transifex

Wekan is an open-source and collaborative kanban board application.

Whether youre maintaining a personal todo list, planning your holidays with some friends, or working in a team on your next revolutionary idea, Kanban boards are an unbeatable tool to keep your things organized. They give you a visual overview of the current state of your project, and make you productive by allowing you to focus on the few items that matter the most.

Wekan supports most features you would expect of it including a real-time user interface.

Features

Integrations

Wekan supports many platforms, and plan is to add more.

SSO options like LDAP, passwordless email, SAML, GitHub and Google Auth are already available on Sandstorm, not standalone Wekan. Sandstorm is Enterprise scale highly secure platform with grains, logging, admin settings, server clustering, App Market and it's now fully Open Source. Sandstorm is preferred platform for Wekan, as it would take a lot of work to reimplement everything in standalone Wekan.

You dont have to trust us with your data and can install Wekan on your own computer or server. In fact we encourage you to do that by providing one-click installation on various platforms.

Roadmap

Upcoming Wekan App Development Platform will make possible many use cases. If you don't find your feature or integration in GitHub issues and Features or Integrations page at wiki, please add them.

We are very welcoming to new developers and teams to submit new pull requests to devel branch to make this Wekan App Development Platform possible faster. Please see Developer Documentation to get started. We also welcome sponsors for features. By working directly with Wekan you get the benefit of active maintenance and new features added by growing Wekan developer community.

Roadmap is self-hosted on Wekan

Roadmaps is not currently up-to-date. You can find more up-to-date info from Features and Integrations pages, where is links to Wekan GitHub issues where actual work happens.

Screenshot

Screenshot of Wekan

Content is being copied from old Wekan roadmap to new one in process of merging Wefork back to Wekan.

Since Wekan is a free software, you dont have to trust us with your data and can install Wekan on your own computer or server. In fact we encourage you to do that by providing one-click installation on various platforms.

Supported Platforms

Automatic generated newest builds are available for Docker, and some others that install directly from this repo. Automatic builds will be added later for more platforms.

Wekan database cleanup script

Daily export of Wekan changes as JSON to Logstash and ElasticSearch / Kibana (ELK)

Wekan stats

Enable Admin Panel on Docker and Source installs

2017-03-31: Alternative Docker image while we are fixing official Docker image, fixing may take one or two weeks. We are also trying to setup New Docker image for Wekan team where it's easier for Wekan team to add tags.

Import/Export MongoDB data to/from Docker container

Docker: Docker image, Docs at wiki

Docker example, running latest Wekan using docker-compose:

Running from remote dockerhub images

Recommended:

Development:

  • Clone this wekan repo and run from dockerhub without building:
sudo docker-compose up -d --nobuild

PostgreSQL read-only mirroring using dockerhub images

Wekan <=> MongoDB <=> ToroDB => PostgreSQL read-only mirroring for SQL access with any programming language or Office package that has PostgreSQL support, like newest LibreOffice 3.5.

Running from locally built dockerhub images

sudo docker-compose up -d --build
echo 'NODE_VERSION=v6.6.0' >> .env && \
echo 'METEOR_RELEASE=1.4.2.3' >> .env && \
echo 'NPM_VERSION=4.1.2' >> .env && \
echo 'ARCHITECTURE=linux-x64' >> .env && \
echo 'SRC_PATH=./' >> .env && \
sudo docker-compose up -d --build

Docker example, running latest Wekan using docker run commands alone:

docker run -d --restart=always --name wekan-db mongo:3.2.11

docker run -d --restart=always --name wekan --link "wekan-db:db" -e "MONGO_URL=mongodb://db" -e "ROOT_URL=http://localhost:8080" -p 8080:80 mquandalle/wekan:latest

Docker on SUSE Linux Enterprise Server 12 SP1

Docker environment for Wekan development

Install from source

Install from source on Windows

VirtualBox

Debian Wheezy 64bit

Deploy SignUp Deploy to Scalingo Install on Cloudron Try on Sandstorm

Upcoming Platforms

Autoinstall script based on this issue

Create Sandstorm .spk file from source

Email to work on already working Heroku: Use 3rd party email like SendGrid, update process.env.MAIL_URL , change from email at Accounts.emailTeamplates.from , new file in server folder called smtp.js on code Meteor.startup(function () }); . TODO: Test and find a way to use API keys instead.

Azure: Install from source. Azure endpoint needs to be added. Not tested yet.

OpenShift: Not tested yet.

Google Cloud: Needs info how to enable websockets.

License

Wekan is released under the very permissive MIT license, and made with Meteor.