Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/wekan/wekan

The Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . New English strings for new features at imports/i18n/data/en.i18n.json . Non-English translations at https://app.transifex.com/wekan/wekan only.
https://github.com/wekan/wekan

docker-image foss javascript kanban meteor real-time sandstorm snapcraft wekan

Last synced: 10 days ago
JSON representation

The Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . New English strings for new features at imports/i18n/data/en.i18n.json . Non-English translations at https://app.transifex.com/wekan/wekan only.

Awesome Lists containing this project

README 

          
# WeKan ® - Open Source kanban



## Downloads



https://wekan.fi/install/



## Docker Containers



- [GitHub](https://github.com/wekan/wekan/pkgs/container/wekan)

- [Quay](https://quay.io/repository/wekan/wekan)

- [Docker Hub](https://hub.docker.com/r/wekanteam/wekan)



docker-compose.yml at https://github.com/wekan/wekan/blob/main/docker-compose.yml



## Standards



- [WeKan and Standard for Public Code](https://wekan.fi/standard-for-public-code/) assessment was made at 2023-11.

  Currently Wekan meets 8 out of 16 criteria out of the box.

  Some others could be met with small changes.



## Code stats



- [CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/4619)

- [Code Climate](https://codeclimate.com/github/wekan/wekan)

- [Open Hub](https://www.openhub.net/p/wekan)

- [OSS Insight](https://ossinsight.io/analyze/wekan/wekan)



## Translate WeKan ® at Transifex



Translations to non-English languages are accepted only at [Transifex](https://app.transifex.com/wekan/wekan) using webbrowser.

New English strings of new features can be added as PRs to master branch file wekan/imports/i18n/data/en.i18n.json .



## WeKan ® feature requests and bugs



Please add most of your questions as GitHub issue: [WeKan ® Feature Requests and Bugs](https://github.com/wekan/wekan/issues).

It's better than at chat where details get lost when chat scrolls up.



## Discussions



[IRC](https://github.com/wekan/wekan/blob/main/docs/FAQ/IRC-FAQ.md)



## Docker: Latest tag has newest release



You can use latest tag to get newest release tag.

See bottom of https://github.com/wekan/wekan/issues/3874



## FAQ



**NOTE**:



- Please read the [FAQ](https://github.com/wekan/wekan/blob/main/docs/FAQ/FAQ.md) first

- Please don't feed the [trolls](https://github.com/wekan/wekan/blob/main/docs/FAQ/FAQ.md#why-am-i-called-a-troll) and [spammers](https://github.com/wekan/wekan/blob/main/docs/FAQ/FAQ.md#why-am-i-called-a-spammer) that are mentioned in the FAQ :)



## About WeKan ®



WeKan ® is a completely [Open Source][open_source] and [Free software][free_software]

collaborative kanban board application with MIT license.



Whether you’re 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.



Since WeKan ® is a free software, you don’t 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.



- WeKan ® is used in [most countries of the world](https://snapcraft.io/wekan).

- WeKan ® largest user has 30k users using WeKan ® in their company.

- WeKan ® has been [translated](https://app.transifex.com/wekan/) to about 105 languages.

- [Features][features]: WeKan ® has real-time user interface.

- [Platforms](https://wekan.fi/install/): WeKan ® supports many platforms.

  WeKan ® is critical part of new platforms Wekan is currently being integrated to.



## Requirements



- 1 GB RAM minimum free for WeKan ®. Production server should have minimum total 4 GB RAM.

  For thousands of users, for example with [Docker](https://github.com/wekan/wekan/blob/main/docker-compose.yml): 3 frontend servers,

  each having 2 CPU and 2 wekan-app containers. One backend wekan-db server with many CPUs.

- Enough disk space and alerts about low disk space. If you run out of disk space, MongoDB database gets corrupted.

- SECURITY: Updating to newest WeKan ® version very often. Please check you do not have automatic updates of Sandstorm or Snap turned off.

  Old versions have security issues because of old versions Node.js etc. Only newest WeKan ® is supported.

  WeKan ® on Sandstorm is not usually affected by any Standalone WeKan ® (Snap/Docker/Source) security issues.

- [Reporting all new bugs immediately](https://github.com/wekan/wekan/issues).

  New features and fixes are added to WeKan ® [many times a day](https://github.com/wekan/wekan/blob/main/CHANGELOG.md).

- [Backups](https://github.com/wekan/wekan/blob/main/docs/Backup/Backup.md) of WeKan ® database once a day minimum.

  Bugs, updates, users deleting list or card, harddrive full, harddrive crash etc can eat your data. There is no undo yet.

  Some bugs can cause WeKan ® board to not load at all, requiring manual fixing of database content.



## Roadmap and Demo



[Roadmap][roadmap_wekan] - Public read-only board at WeKan ® demo.



[Developer Documentation][dev_docs]



- There are many companies and individuals contributing code to WeKan ®, to add features and bugfixes

  [many times a day](https://github.com/wekan/wekan/blob/main/CHANGELOG.md).

- [Please add Add new Feature Requests and Bug Reports immediately](https://github.com/wekan/wekan/issues).

- [Commercial Support](https://wekan.fi/commercial-support/).



We also welcome sponsors for features and bugfixes.

By working directly with WeKan ® you get the benefit of active maintenance and new features added by growing WeKan ® developer community.



## Getting Started with Development



The default branch uses Meteor 3.5-beta.7 with Node.js 24.x.

See [CHANGELOG.md](https://github.com/wekan/wekan/blob/main/CHANGELOG.md) for the latest runtime updates.



To contribute, [create a fork](https://github.com/wekan/wekan/blob/main/docs/DeveloperDocs/Build-and-Create-Pull-Request.md#2-create-fork-of-httpsgithubcomwekanwekan-at-github-web-page) and run `./rebuild-wekan.sh` (or `./rebuild-wekan.bat` on Windows) as detailed [here](https://github.com/wekan/wekan/blob/main/docs/DeveloperDocs/Build-and-Create-Pull-Request.md#3-select-option-1-to-install-dependencies-and-then-enter). Once you're ready, please test your code and [submit a pull request (PR)](https://github.com/wekan/wekan/blob/main/docs/DeveloperDocs/Build-and-Create-Pull-Request.md#7-test).



Please refer to the [developer documentation](https://github.com/wekan/wekan/blob/main/docs/DeveloperDocs/Developer-Documentation.md) for more information.



## First-Time Setup for Development



### Prerequisites



Before building WeKan from source, ensure you have:



- **Git** - for cloning the repository

- **Node.js 24.x** - WeKan requires Node.js 24.x

- **Meteor** - the JavaScript framework WeKan is built with



### Installing Node.js 24.x



```bash

# Using nvm (recommended)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

source ~/.zshrc  # or ~/.bashrc

nvm install 24

nvm use 24

```



### Installing Meteor



```bash

curl https://install.meteor.com/ | sh

```



### Building WeKan



The `rebuild-wekan.sh` script guides you through a three-stage process:



1. **Install dependencies (Option 1)** - Downloads all required Meteor packages and npm modules

2. **Build WeKan (Option 2)** - Compiles the application

3. **Run WeKan (Option 3)** - Starts the development server at http://localhost:4000



```bash

# Clone your fork

git clone git@github.com:YOUR_USERNAME/wekan.git

cd wekan



# Make the script executable

chmod +x rebuild-wekan.sh



# Step 1: Install dependencies

./rebuild-wekan.sh

# Press 1 and Enter



# Step 2: Build WeKan (after dependencies complete)

./rebuild-wekan.sh

# Press 2 and Enter



# Step 3: Run WeKan in development mode

./rebuild-wekan.sh

# Press 3 and Enter

```

 



### WSL Users



WSL users can use Snap Candidate. See [install docs](https://wekan.fi/install/).



The development server will start at http://localhost:4000. Any changes you make to the source code will automatically trigger a rebuild and refresh your browser.



## Screenshot



[More screenshots at Features page](https://github.com/wekan/wekan/tree/main/docs/Features)



[![Screenshot of WeKan ®][screenshot_wekan]][roadmap_wekan]



## License



WeKan ® is released under the very permissive [MIT license](LICENSE), and made

with [Meteor](https://www.meteor.com).



[dev_docs]: https://github.com/wekan/wekan/blob/main/docs/DeveloperDocs/Developer-Documentation.md

[screenshot_wekan]: https://wekan.fi/wekan-dark-mode.png

[features]: https://github.com/wekan/wekan/wiki/Features

[roadmap_wekan]: https://boards.wekan.team/b/D2SzJKZDS4Z48yeQH/wekan-open-source-kanban-board-with-mit-license

[wekan_issues]: https://github.com/wekan/wekan/issues

[docker_image]: https://hub.docker.com/r/wekanteam/wekan/

[translate_wekan]: https://app.transifex.com/wekan/wekan/

[open_source]: https://en.wikipedia.org/wiki/Open-source_software

[free_software]: https://en.wikipedia.org/wiki/Free_software