Skip to content
Lauri Ojansivu edited this page Aug 31, 2022 · 33 revisions
Wekan logo Powered by MacStadium

ChangeLog

  • Previously:
  • 2021-05-14 Wekan maintainer xet7 got donated hardware OpenSource MacStadium remote access to Mac Mini M1 that has 16 GB RAM and 1 TB SSD.
  • 2021-05-15 xet7 bought Apple Developer access for 99 euro/year. Trying to figure out how to sign some test app for iPhone, did not get it working yet.
  • 2021-05-16 Instructions added below by xet7 about how to run Wekan Server Node.js/MongoDB for development on M1.
  • 2021-06-21 xet7 got iPhone 12 mini for testing prototypes locally. Some testing of coding tools on M1.
  • TODO:

Mac M1 Wekan development

Meteor includes Node.js and MongoDB version, when developing. But if not developing, those can be installed like below in Bundle section.

  1. Install rosetta:
softwareupdate --install-rosetta --agree-to-license
  1. Clone Wekan:
git clone https://github.com/wekan/wekan
cd wekan
  1. Install Meteor etc
curl https://install.meteor.com/ | arch -x86_64 sh
arch -x86_64 meteor npm install --save @babel/runtime

3a) Run Meteor on localhost port 4000:

WRITABLE_PATH=.. WITH_API=true RICHER_CARD_COMMENT_EDITOR=false arch -x86_64 meteor --port 4000

3b) Run Meteor on computer IP address on local network port 4000:

WRITABLE_PATH=.. ROOT_URL=http://192.168.0.100:4000 PORT=4000 WITH_API=true RICHER_CARD_COMMENT_EDITOR=false arch -x86_64 meteor --port 4000

Bundle for non-devepment use with start-wekan.sh

  1. Maybe install XCode, and Node.js from https://nodejs.org/dist/latest-v14.x/ , and MongoDB 5.x from https://www.mongodb.com/try/download/community
  2. Download wekan-VERSIONNUMBER.zip from https://releases.wekan.team
  3. Unzip file you downloaded at step 2. There will be directory called bundle.
  4. Download start-wekan.sh script to directory bundle and set it as executeable with chmod +x start-wekan.sh
  5. Install Node.js version mentioned at https://wekan.github.io Download section
  6. Install MongoDB version mentioned at https://wekan.github.io Download section with Mac install info
  7. Edit start-wekan.sh so that it has for example:
export WRITABLE_PATH=..
export ROOT_URL=http://localhost:2000
export PORT=2000
export MONGO_URL=mongodb://127.0.0.1:27017/wekan

More info about ROOT_URL

  1. Edit start-wekan.sh so that it starts in bundle directory command node main.js

Build bundle from source and develop Wekan

  1. Install XCode
  2. With steps 3-6 fork and clone your fork of Wekan

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

Wekan

General

Security

Scaling

Migrating

Support priorities for new features and bugfixes

  1. Commercial Support
  2. Community Support
  3. Debugging

Backup

Repair

Themes

Markdown Syntax

Login Auth

Metrics, Logs, Stats

Integrations

Time

Features

Email

Required Settings

Download

Webservers

REST API Docs

REST API issue

REST API client code

Webhooks

Case Studies

Development

Issues

Clone this wiki locally