Also see: Windows
Other CPU/OS On-Premise WeKan install
Wekan Windows 64bit version On-Premise
INFO ABOUT SETTINGS: https://github.com/wekan/wekan/issues/5591#issuecomment-2503681293
This is without container (without Docker or Snap).
Right click and download files 1-4:
-
Copy files from steps 1-4 with USB stick or DVD to offline Windows computer
-
Double click
mongodb-windows-x86_64-7.0.21-signed.msi. In installer, uncheck downloading MongoDB compass. -
Unzip
wekan-7.92-amd64-windows.zip, inside it is directorybundle, to it copy other files:
bundle (directory)
|_ start-wekan.bat (downloaded file)
|_ node.exe (downloaded file)
|_ main.js (extracted file)
- Edit
start-wekan.batwith Notepad. There add Windows computer IP address , like this, then Wekan will be at http://IP-ADDRESS-HERE/sign-in , for example http://192.168.0.100/sign-in but your different IP address. Add there wekan server computer IP address, not localhost.node.exe main.jsis at bottom ofstart-wekan.bat, change there longer filename:
SET ROOT_URL=http://IP-ADDRESS-HERE
SET PORT=80
node.exe main.js
If there is already some webserver at port 80, change to other port:
REM # Writable path required to exist and be writable for attachments to migrate and work correctly
SET WRITABLE_PATH=..
SET ROOT_URL=http://IP-ADDRESS-HERE:2000
SET PORT=2000
Then Wekan will be at http://IP-ADDRESS-HERE:2000/sign-in , for example http://192.168.0.100/sign-in , but with your different IP address.
-
Double click
start-wekan.batto run it. Give permission to network. If it does not work, try instead with right click, Run as Administrator. -
For mobile devices, you can create PWA app icon using that http://IP-ADDRESS-HERE:2000/sign-in
RELATED INFO:
- Windows 2022 server example https://github.com/wekan/wekan/issues/5084
- Other settings example https://github.com/wekan/wekan/issues/4932
Docker WeKan Offline
At Internet connected computer, download:
- Docker for Windows
- docker-compose.yml from https://github.com/wekan/wekan
docker-compose up -dat Internet connected computer- Save wekan-app and wekan-db containers to files https://docs.docker.com/engine/reference/commandline/save/
At Offline Windows computer:
- Install Docker for Windows
- Load
wekan-appcontainer from file https://docs.docker.com/engine/reference/commandline/load/ - Check what is ID of
wekan-appcontainer withdocker images - Change at
docker-compose.ymlwekan-app contaierimage:gc....toimage:IDwhere ID from step 3 above - Do steps 2-4 also for
wekan-dbcontainer docker-compose up -d
WeKan Updates
- Updating only WeKan. Not updating Node.js and MongoDB.
1.1. Make backup, look at steps 2.1. and 2.2 below.
1.2. Download newest WeKan bundle .zip file from https://github.com/wekan/wekan/releases
1.3. Replace old bundle with new from that .zip file.
1.4. Start WeKan with start-wekan.sh
- If it does not work, you maybe need to update Node.js and MongoDB.
2.1. Backup part 1/2. Try mongodump to backup database like this command. If mongodump command does not exist, download MongoDB Tools from https://www.mongodb.com/try/download/database-tools . Make backup:
mongodump
Backup will be is in directory dump. More info at https://github.com/wekan/wekan/wiki/Backup
2.2. Backup part 2/2. If there is files at WRITABLE_PATH directory mentioned at start-wekan.bat of https://github.com/wekan/wekan , also backup those. For example, if there is WRITABLE_PATH=.., it means previous directory. So when WeKan is started with node main.js in bundle directory, it may create in previous directory (where is bundle) directory files, where is subdirectories like files\attachments, files\avatars or similar.
2.3. Check required compatible version of Node.js from https://wekan.github.io Install WeKan ® Server section and Download that version node.exe for Windows 64bit from https://nodejs.org/dist/
2.4. Check required compatible version of MongoDB from https://wekan.github.io Install WeKan ® Server section and Download that version Windows MongoDB .msi installer from https://www.mongodb.com/try/download/community
2.5. Remove old Node.js and MongoDB (at Windows, Control Panel / Add Remove Programs).
2.6. Install newest Node.js and MongoDB.
2.7. Restore database with mongorestore, like this:
mongorestore --drop
If there are errors, try this instead:
mongorestore --drop --noIndexRestore
2.8. Start wekan with start-wekan.bat
2.9. If WeKan does not start with your old start-wekan.bat, download newest start-wekan.bat and look are there differences to your old start-wekan.bat . For example, with this command, could work on WSL or PowerShell or Linux or after installing git:
diff old-start-wekan.bat start-wekan.bat
b) How to fix errors on Linux bundle to create Windows bundle
Download Linux bundle wekan-VERSION.zip from from https://github.com/wekan/wekan/releases or https://releases.wekan.team/
npm install -g node-pre-gyp
cd bundle\programs\server\npm\node_modules\meteor\accounts-password
npm remove bcrypt
npm install bcrypt
c) WSL
d) Wekan to VirtualBox Ubuntu offline
-
Install newest VirtualBox
-
Install newest Ubuntu 64bit to VirtualBox
-
Install Wekan Snap version to Ubuntu with these commands:
sudo snap install wekan
-
Shutdown Ubuntu
-
At VirtualBox menu, export appliance to
wekan.ovafile -
Copy
virtualbox-install.exeandwekan.ovato offline computer -
At offline computer, install virtualbox and import wekan.ova
-
Set virtualbox network to bridged: https://github.com/wekan/wekan/wiki/virtual-appliance#how-to-use
-
Start VirtualBox and Ubuntu
-
In Ubuntu, type command:
ip address
=> it will show Ubuntu IP address
- In Ubuntu Terminal, type with your IP address, at below instead of 192.168.0.100:
sudo snap set wekan root-url='http://192.168.0.100'
sudo snap set wekan port='80'
- Then at local network Wekan is at: http://192.168.0.100
Wekan
General
- 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
Fake: Not WeKan kanban
Security
- Allow private boards only: Disable Public Boards
- Security Disclosure and details of Security in Wekan
- Security issues
- Password Hashing
Scaling
- Cron: Hourly restart WeKan, because of memory leaks
- Maybe: 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
Migrating
- 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
Support priorities for new features and bugfixes
Backup
Repair
- Repair MongoDB
- Using Meteor MongoDB to repair files
- If board does not open and keeps loading
- Repair Docker
Themes
Markdown Syntax
- Wekan Markdown
- Emoji
- Mermaid Diagram DOES NOT WORK ANYMORE
- Numbered text
Login Auth
- Automatic login
- Disable Password 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
Metrics, Logs, Stats
Integrations
Time
Features
- Multiline
- Linked Cards
- 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
Required Settings
Download
- Download Wekan for various Platforms: Supported by xet7, Operating Systems, NAS, Cloud
- Helm Chart for Kubernetes
Webservers
- Caddy
- Nginx
- Apache
- OpenLiteSpeed
- Local self signed TLS
- Let's Encrypt and Google Auth
- TLS with Node.js
- Traefik and self-signed SSL certs
REST API Docs
REST API issue
REST API client code
- 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
Webhooks
- 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
Case Studies
Development
- Kadira integration
- Debugging
- Developer Docs for Standalone Wekan
- Developer Docs for Sandstorm Wekan
- Adding new Snap setting to code
- Directory Structure
- Building Wekan for Sandstorm
- Docs - Sandstorm etc
- Beginner
- Maintainer FAQ
Issues
Wekan - OpenSource Kanban