Skip to content

virtual appliance

Lauri Ojansivu edited this page Nov 17, 2018 · 21 revisions

Virtual Appliance by xet7

Requirements: VirtualBox version 5.2.22 or newer. Old versions of VirtualBox are not compatible. Both of these have username: wekan , password: wekan , Network Bridged mode so VM has separate IP address so you can also ssh to it.

Wekan for VirtualBox bug reports and feature requests

a) For general Wekan usage: Only Wekan and building it from source in Ubuntu 14.04 64bit VM.

Download wekan-VERSION.ova at

b) For Developers, only this one Wekan-Sandstorm.ova needed for all development: for compiling Wekan, Sandstorm, Wekan for Sandstorm, etc, all. Also has Snap, Docker, Firefox, Chrome, Visual Studio Code with Meteor.js additions, GHex hex editor, etc. Based on Debian 9 64bit. Also see about what dependencies were installed for compiling Sandstorm, although after that dependencies have been changed to automatically download up-to-date Clang from Chromium project, so it's easier to compile Sandstorm also on Ubuntu, without using Clang ppa.

Wekan-Sandstorm-VERSION.ova at

Build scripts

Scripts from virtual appliance, can be used on any Ubuntu 14.04 64bit or Debian 9 or newer install like native or VM. Includes script how to run Node.js on port 80.

Wekan Meteor 1.4 and Node.js v4.x version on Ubuntu 14.04 64bit desktop, Gnome fallback, in VirtualBox

  • Ubuntu 14.04 64bit desktop with latest updates.
  • Wekan installed from source.
  • Includes VirtualBox Guest Additions.


.ova files can be downloaded at

VirtualBox .ova file contains harddisk image that has current size of 16 GB and maximum growable size of 500GB.

You can enlarge it with VBoxManage command and then starting with LiveCD iso deleting logical swap and extended and resizing and creating extended and inside it logical swap.

Size of this VirtualBox image has been reduced:

Use 7zip (Windows) or p7zip (Linux etc) to unarchive.

Updating VirtualBox image to have newest Wekan

Download newest VirtualBox scripts:

There is script

First do some sudo command so you get to insert sudo password, for example:

sudo ls

Then run script as as normal user:


Run it with option 1 at first to install dependencies, and then option 3 to rebuild source code.

Updating to newest Ubuntu updates

sudo apt-get update

( password: wekan )

sudo apt-get -y dist-upgrade


When using VirtualBox bridged mode, you can browse from other computer to http://ipadress to use Wekan. Node runs on port 80 and is started from /etc/rc.local on boot. See also README.txt at Ubuntu desktop, scripts at ~/repos directory, and /home/wekan/.bash_history how it was installed, including typos :)

To login to the virtual machine with ssh port 22:

username: wekan

password: wekan

Install VirtualBox

VirtualBox is available for example Windows, Mac, Linux and Solaris from:

How to use

a) Import Virtual Appliance .ova

b) Extract .ova to use as .vmdk for virtualization raw .img for Qubes OS:

These settings are for example with VirtualBox:

  • new Ubuntu 64bit VM
  • 2GB RAM
  • Add Wekan.vmdk as harddisk.
  • Not needed usually: Audio, Serial Ports, USB
  • Network: If you select Bridged Adapter, name is your network you use, like eth0 / exp9s0 for Ethernet, and there's also wlan etc if available:


If you select NAT to keep virtual machine using same address as your server:


Then you can also setup port forwarding to Wekan VM port 8080:


  1. Start VM

  2. To access Wekan on local network, setup ROOT_URL to your IP address at /home/wekan/repos/ inside VM.

cd repos


  1. Add have there your IP address, for example:
export ROOT_URL=

export MAIL_URL=smtp://

export MAIL_FROM='Example Wekan Support <>'
  1. Save with Ctrl-o Enter and after that exit with Ctrl-x

  2. Allow port 80 and start Wekan:


  1. Access Wekan at your network with IP address of VM, for example

More details of settings at:

Virtual Appliance by anselal

You can download a virtual appliance from

To login to the virtual machine use:

  • username: wekan
  • password: wekan

You can find more information at including the script which was used to create the Virtual Appliance.



Support priorities for new features and bugfixes

  1. Commercial Support and Bounties
  2. Community Support
  3. Debugging






Logs and Stats






REST API issue

REST API client code


Case Studies



Clone this wiki locally
You can’t perform that action at this time.