Skip to content
Lauri Ojansivu edited this page Mar 19, 2020 · 24 revisions

a) Bundle with Windows Node+MongoDB

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.

  1. If you have important data in Wekan, do backup.

  2. Install newest Node.js v12.x.x for Windows https://nodejs.org/dist/v12.16.1/

  3. Install MongoDB 4.x for Windows https://www.mongodb.com/download-center/community

  4. Download and newest Wekan bundle wekan-3.xx.zip from https://releases.wekan.team

  5. Unzip wekan-3.xx.zip, it has directory name bundle

  6. Like at bundle wiki page, similarly do for bundle:

cd bundle/programs/server
npm install
npm install node-gyp node-pre-gyp fibers
cd ..\..\..
  1. Download start-wekan.bat to your bundle directory. Edit it for your ROOT_URL etc settings.

  2. Start Wekan:

cd bundle
start-wekan.bat
  1. Add users.

b) Docker

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

c) Windows Subsystem for Linux on Windows 10

  • 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.

e) Probaby does not work

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.

d) Install Meteor on Windows - does not build correctly, gives errors

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"

Related

Linux stuff in Windows 10 part 1 and part 2.

Wekan

General

Support priorities for new features and bugfixes

  1. Commercial Support
  2. Community Support
  3. Debugging

Security

Backup

Repair

Themes

Features

Email

Logs and Stats

Migrating

Required Settings

Download

Webservers

REST API Docs

REST API issue

REST API client code

Webhooks

Case Studies

Development

Issues

Clone this wiki locally