Windows
Use these instructions instead: Offline
Windows Updates:
- WuMgr: Windows Update but Not Automatic
- Legacy Update
- Win7 Extended Security Updates Ending
- https://news.ycombinator.com/item?id=34307029
- How to create Win7.iso with all updates
- Snappy Driver installer
This has highest performance and lowest RAM usage, because there is no virtualization like Docker, Windows Subsystem for Linux, etc. Wekan is run with Windows native version of Node.js and MongoDB, directly at Windows filesystem.
-
If you have important data in Wekan, do backup.
-
Install newest Node.js LTS v12.x for Windows from https://nodejs.org . When installing, checkmark "Install additional tools" that will install also Chocolatey etc.
-
Run cmd.exe as Administrator, and there type:
choco install -y mongodb
-
Download and newest Wekan bundle wekan-x.xx.zip from https://releases.wekan.team
-
Unzip wekan-x.xx.zip, it has directory name
bundle
-
Download start-wekan.bat to your bundle directory. Default settins are:
ROOT_URL=http://localhost
andPORT=80
, so it works only in local compatible browser. You can edit ROOT_URL to be orhttp://YOUR-IP-ADDRESS
so it works on local network withhttp://YOUR-IP-ADDRESS
. -
Start Wekan in cmd.exe as Administrator:
cd bundle
start-wekan.bat
- Start MongoDB cmd.exe as Administrator:
net start mongodb
You can also stop MongoDB this way:
net stop mongodb
When you have MongoDB running, you can connect to database with nosqlbooster GUI, to localhost 27017.
You can create backup of MongoDB database with this mongodump command, that is similar to mysqldump:
"C:\Program Files\MongoDB\Server\4.2\bin\mongodump"
It will create subdirectory dump
that contains backup. You can restore with:
"C:\Program Files\MongoDB\Server\4.2\bin\mongorestore"
You can connect to MongoDB CLI with this command:
"C:\Program Files\MongoDB\Server\4.2\bin\mongo"
There you can show databases. One MongoDB server can have many databases, similarly like MySQL server can have many databases created with MySQL CREATE DATABASE
command:
show dbs
Then use Wekan database:
use wekan
List wekan database collections/tables:
show collections
Show content of users collection/table:
db.users.find()
Create new database:
use testing
Delete current database:
db.dropDatabase()
List databases again to show that database testing is not there anymore:
show dbs
Also see Forgot Password
Exit MongoDB CLI:
exit
You should not backup Windows MongoDB RAW database files that are here, when you in File Explorer folder properties show hidden system files and file extensions:
C:\ProgramData\MongoDB\data\db
b) Docker
Note: With Docker, please don't use latest tag. Only use release tags. See https://github.com/wekan/wekan/issues/3874
If you don't need to build Wekan, use prebuilt container with docker-compose.yml from https://github.com/wekan/wekan like this:
docker-compose up -d
If you like to build from source, clone Wekan repo:
git clone https://github.com/wekan/wekan
Then edit docker-compose.yml with these lines uncommented this way:
#-------------------------------------------------------------------------------------
# ==== BUILD wekan-app DOCKER CONTAINER FROM SOURCE, if you uncomment these ====
# ==== and use commands: docker-compose up -d --build
build:
context: .
dockerfile: Dockerfile
args:
- NODE_VERSION=${NODE_VERSION}
- METEOR_RELEASE=${METEOR_RELEASE}
- NPM_VERSION=${NPM_VERSION}
- ARCHITECTURE=${ARCHITECTURE}
- SRC_PATH=${SRC_PATH}
- METEOR_EDGE=${METEOR_EDGE}
- USE_EDGE=${USE_EDGE}
#-------------------------------------------------------------------------------------
Then you can build Wekan with
docker-compose up -d --build
-
Install Windows Subsystem for Linux in PowerShell as Administrator
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
and reboot - Install Ubuntu 18.04 from Windows Store
If you don't need to build from source, download newest wekan-VERSION.zip from https://releases.wekan.team and unzip it. Then:
sudo apt update
sudo apt install npm mongodb-server mongodb-clients
sudo npm -g install n
sudo n 12.16.1
sudo npm -g install npm
Then edit start-wekan.sh
to start at correct port, ROOT_URL setting, and MONGO_URL to port 27017, cd to correct bundle directory where node main.js
can be run, and then:
./start-wekan.sh
More info at https://github.com/wekan/wekan/wiki/Raspberry-Pi
- You could try to proxy from IIS SSL website to Wekan localhost port, for example when ROOT_URL=https://example.com and PORT=3001 , and you make IIS config that supports websockets proxy to Wekan http port 3001.
If you need to build from source, do as above, and build Wekan with wekan/rebuild-wekan.sh
.
After building, if you like to start meteor faster by excluding some parts, have rebuilds after file change, and test on local network devices, try with your computer IP address:
WITH_API=true RICHER_CARD_COMMENT_EDITOR=false ROOT_URL=http://192.168.0.200:4000 meteor --exclude-archs web.browser.legacy,web.cordova --port 4000
Install Ubuntu to VirtualBox and then Wekan, for example Wekan Snap.
Currently Snap works only when installed to Ubuntu 19.10 64bit running on VirtualBox VM.
https://github.com/wekan/wekan-snap/wiki/Install
Related VM info how to expose port with bridged networking
UCS has prebuilt VirtualBox VM
Install from source directly on Windows to get Wekan running natively on Windows. git clone on Windows has been fixed. Related: running standalone and nexe.
https://github.com/zodern/windows-meteor-installer/
REM Install Chocolatey from
REM https://chocolatey.org/install
REM in PowerShell as Administrator
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
REM Install with cmd.exe or PowerShell as Administrator
REM - nodejs-lts, that is 12.x
REM - ndm, that is npm package manager for Windows
choco install -y nodejs-lts ndm git
REM Close and open cmd.exe or PowerShell as normal user.
REM Update npm:
npm -g install npm
REM Install meteor using https://github.com/zodern/windows-meteor-installer/
npm i -g @zodern/windows-meteor-installer
REM Close and open cmd.exe or PowerShell as normal user.
git clone https://github.com/wekan/wekan
cd wekan
REM a) For development, available at local network, at your computer IP address. Does rebuild when code changes.
SET WITH_API=true
SET RICHER_CARD_EDITOR=false
SET ROOT_URL=http://192.168.0.200:4000
meteorz --port 4000
REM b) For development, available only at http://localhost:4000 . Does rebuild when code changes.
SET WITH_API=true
SET RICHER_CARD_EDITOR=false
meteorz --port 4000
REM c) For production, after Wekan is built to "wekan/.build/bundle",
REM edit "start-wekan.bat" to "cd" to correct bundle directory to run "node main.js"
Wekan - OpenSource Kanban
- Deep Dive Into WeKan
- Meteor WeKan Roadmap - board at Wekan demo
- Multiverse WeKan Roadmap
- Docs/Manual
- Change Language
- Forgot Password
- About
- Test Edge
- WeKan Design Principles
- FAQ
- IRC FAQ - answers to questions asked at IRC
- Team
- Press
- Blog
- Wekan vs Trello vs Restyaboard
- Results of Survey 2020-01
- Allow private boards only: Disable Public Boards
- Security Disclosure and details of Security in Wekan
- Security issues
- Password Hashing
- Add more RAM to Node.js to prevent crash
- Clustering AWS etc
- Scaling
- Kubernetes
- Redis Oplog
- Meteor Scaling at Meteor Cloud
- Scaling at Meteor forums
- From Previous Export, paste big WeKan JSON
- Progress: Import/Export/Sync
- From CSV/TSV
- From Trello
- From Jira
- From Asana
- From Zenkit
- From old Wekan manually
- Converting Meteor Stylus to CSS
- Repair MongoDB
- Using Meteor MongoDB to repair files
- If board does not open and keeps loading
- Repair Docker
- Wekan Markdown
- Emoji
- Mermaid Diagram DOES NOT WORK ANYMORE
- Numbered text
- Automatic login
- Forgot Password
- Admin: Impersonate user
- Adding Users
- Active users Presence
- Accounts Lockout: Brute force login protection
- LDAP
- LDAP AD Simple Auth
- Keycloak
- Google login
- Azure
- OAuth2, Auth0, GitLab, RocketChat
- Oracle OIM on premise using OAuth2
- ADFS 4.0 using OAuth2 and OpenID
- Azure AD B2C using OAuth2
- Nextcloud
- CAS Please test
- SAML Please test
- Zitadel
- Drag Drop on Mobile and Desktop
- Rclone: Store attachments to cloud storage like S3, MinIO, etc
- Python based features
- Burndown and Velocity Chart
- Wait Spinners
- Translations
- Default Language for All Users
- Roadmap
- Features
- Planning Poker
- Scaling
- Custom Logo
- Subtasks <== Has fix
- Templates
- Cover
- Archive and Delete
- Custom Fields
- Fix Export board menu not visible on some boards
- RAM usage
- Demo
- Swimlane Documentation
- Customize Translations
- Download Wekan for various Platforms: Supported by xet7, Operating Systems, NAS, Cloud
- Helm Chart for Kubernetes
- Caddy
- Nginx
- Apache
- OpenLiteSpeed
- Local self signed TLS
- Let's Encrypt and Google Auth
- TLS with Node.js
- Traefik and self-signed SSL certs
- Example: New card with Python3 and REST API
- Python client to REST API
- Go client to REST API
- Java
- Wekan Sandstorm cards to CSV using Python
- Excel and VBA
- Global Webhook
- Limiting Webhook data
- Receiving Webhooks
- Outgoing Webhook to Discord/Slack/RocketChat/Riot
- Outgoing Webhook to NodeRed
- Outgoing Webhook to PowerShell
- Security: Webhook and CA
- Outgoing Webhooks Data
- Outgoing Webhooks and Let's Encrypt
- Outgoing Webhooks Original Pull Request, multiple Webhooks, more parameters and response order