Files
wekan/docs/Platforms/FOSS/OS/Android.md
T
Lauri Ojansivu 52b0ea0d81 Android: share to WeKan from other apps.
The web app manifest declares a share_target, so on a phone where WeKan
is installed as an app it appears in Android's Share menu. Sharing a web
page, a note or a message opens /share-target, "Add to WeKan": pick a
board and a list, and what was shared becomes a card there - the page's
title or the text's first line as the title, the text and the address in
its description, the address once - and the card opens. Only boards the
member may add cards to are offered, and the server checks the right to
write in that list, on that board, as for any card added.

models/lib/shareTarget.js turns a share into a card and holds the
manifest's declaration; tests/shareTarget.test.cjs covers what browsers,
notes and chat apps share, an empty share, javascript: addresses, the
manifest, the route and the server's checks. Documented in
docs/Platforms/FOSS/OS/Android.md. The four new strings are English
placeholders until the next translation pass.

Thanks to memeplex and xet7 !

Fixes #1293.
2026-10-14 14:55:04 +03:00

3.7 KiB

Running Wekan server at Android

Requirements:

  • arm64 or x64 Android with at least 3 GB RAM. Tested with with arm64 OnePlus 3 that has 6 GB RAM.
  • It is not necessary to root Android.

1) Install AnLinux and Termux from Play Store

At AnLinux choose:

  • Ubuntu
  • XFCE4
  • Copy those commands to Termux to install Linux.

2) At Termux

When you get from Termux to Ubuntu bash, you can install Wekan similarly like arm64 or x64: Raspberry Pi

Edit start-wekan.sh so you can start Wekan for example:

ROOT_URL=http://localhost:2000
PORT=2000

At Android webbrowser like Chrome and Firefox browse to http://localhost:2000

3) WLAN

If you connect to WLAN, you can get your IP address with command:

ip address

Edit start-wekan.sh so you can start Wekan for example:

ROOT_URL=http://IP-ADDRESS:2000
PORT=2000

Then you can use any computer or mobile phone Javascript capable webbrowser at WLAN to use Wekan at http://IP-ADDRESS:2000 like http://192.168.0.100:2000 . More info about ROOT_URL.

4) Optional: Mobile Linux Desktop

Requirements:

  • 1 WLAN, for example: mobile hotspot, Android device sharing WLAN, hotel WLAN, office WLAN
  • ChromeCast that is connected to HDMI Input of hotel/office/home TV and WLAN
  • Bluetooth keyboard
  • Bluetooth mouse
  • 1 Android device that has:
    • Wekan installed according to steps 1-3 above
    • Android VNC client to local AnLinux Ubuntu desktop
    • Firefox installed with apt-get to that Ubuntu desktop, browsing Wekan at http://IP-ADDRESS:2000
    • Using ChromeCast to show Android full screen at TV

This way, you have:

  • Big TV display
  • Full size keyboard and mouse
  • Full featured Firefox at Ubuntu Desktop using Wekan

WeKan bundles for Termux

Every release that has wekan/node-patches' Android Node.js also has, for each Android CPU, wekan-<version>-android-arm64.zip, -android-x64.zip, -android-armv7.zip and -android-x86.zip: the ordinary bundle, with FerretDB, rebuilt for Termux. In Termux:

pkg install libvips unzip
unzip wekan-<version>-android-arm64.zip
cd bundle
./start-wekan.sh

libvips is what sharp uses for thumbnails; Node.js itself carries its C++ library and needs only Android's own libc.

How it is made (.github/workflows/android.yml, releases/android/build-bundle.sh): the release's Linux bundle of that CPU is rebuilt inside Termux's own image - Android's libc and Android clang, the ARM ones on ARM runners - with node-android-<cpu> from wekan/node-patches, checked against its SHA256. npm reinstalls the server's packages run by that Node.js, so every native addon is built for it, and sharp from source against Termux's libvips. Each addon's architecture is checked, sharp must load, and the bundle must start and answer HTTP 200 before it is published. FerretDB and the MongoDB Database Tools are static Go programs and run as they are. A CPU whose Android Node.js is not published yet is skipped, and builds by itself the release it appears. tests/androidBundles.test.cjs covers the build and the workflow.

Share to WeKan from other apps

#1293. Install WeKan on the phone as an app: open your WeKan in Chrome (or another browser that installs web apps) and choose Install app / Add to Home screen. WeKan then appears in Android's Share menu. Sharing a web page, a note or a message to it opens Add to WeKan: pick a board and a list, and what was shared becomes a card there - the page's title or the text's first line as the card title, the text and the address in its description - and the card opens.

Only boards you may add cards to are offered, and the server checks your right to write in the chosen list, as it does for any card you add.