How To Install Wekan Server on Ubuntu 22.04 | Easy Steps

In this guide on the Orcacore website, we want to teach you How To Install Wekan Server on Ubuntu 22.04. Wekan is an open-source tool that offers multiple features to maintain daily tasks through virtual cards. It is a fantastic Trello-like Kanban board based on the Meteor Javascript framework and licensed by MIT. Wekan is a tool that can help you manage your projects.

Wekan is beneficial for keeping things organized, planning tasks, creating personal to-do lists, managing teams, etc. This tool allows you to use a colored label on different cards for facilitating filtering, project grouping, and assigning projects to a particular person. Installing Wekan is a great way to improve team collaboration.

To complete this guide, you must log in to your server as a non-root user with sudo privileges. To do this, you can follow our guide on Initial Server Setup with Ubuntu 22.04.

Check for the Video tutorial here:

1. Install Wekan with Snap on Ubuntu 22.04

In this guide, we use the snap package management to install Wekan server on Ubuntu 22.04. First, you need to update your local package index with the following command:

sudo apt update

Then, you need to install snap on your server with the command below:

sudo apt install snapd -y

Now you can use the snap command to install Wekan on your Ubuntu 22.04:

sudo snap install wekan

When your installation is completed you will see:

**Output**
wekan 6.09 from Lauri Ojansivu (xet7) installed

2. Configure Wekan on Ubuntu 22.04

At this point, you need to configure the root of the web URL for the Wekan server with the following command:

sudo snap set wekan root-url="http://<mark>your_server_ip</mark>"

Here you need to set a port number on Ubuntu 22.04 to access the Wekan server through your browser.

Note: Set a port number to one that isn’t in use. You can use whatever port you want—we use port 3001—but don’t use a common one, like 22, 25, 443, 80, etc.

sudo snap set wekan port='<mark>3001</mark>'

Now you should restart the MongoDB service on snap with the following command:

sudo systemctl restart snap.wekan.mongodb

Also, you should restart the Wekan server on snap:

sudo systemctl restart snap.wekan.wekan

You can check your Wekan service status with the command below:

sudo ss -tunelp | grep 3001

**Output**
tcp   LISTEN 0      511          0.0.0.0:3001       0.0.0.0:*    users:(("node",pid=13013,fd=24)) ino:47932 sk:3 cgroup:/system.slice/snap.wekan.wekan.service <->

Next, enable your Wekan service to start on boot on Ubuntu 22.04:

sudo snap enable wekan

Finally, you need to reload the snap:

sudo snap refresh

3. Access Wekan Kanban Web Interface

At this point, you can access your Wekan web interface by typing your server’s IP address in your web browser followed by the port that you have defined before.

http://<mark>Server-IP</mark>:<mark>3001</mark>

You will see the Wekan sign-in screen. If you are logging in for the first time, click on Register.

Here you will see the Create an Account page. Complete the information and click on Register. You may get an error; don’t worry, just ignore it.

At this point, you will see your Wekan dashboard on Ubuntu 22.04.

Here is the list of features offered by Wekan:

Conclusion

At this point, you have learned to Install and Configure the Wekan Server on Ubuntu 22.04. You can easily use the snap package manager to get Wekan and start using it. This guide on How To Install Wekan Server on Ubuntu 22.04 provides a quick and easy method.

Hope you enjoy it. Please subscribe to us on Facebook, Instagram, X, and YouTube.

You may also like these articles:

Install Mozilla Firefox in Ubuntu Using Terminal

Install Postfix Mail Server on Ubuntu 22.04

How To Create Tar.Gz File in Linux

Install Let’s Encrypt on cPanel New Version

Installing aaPanel on Ubuntu 24.04

Alternative Installation Methods for Wekan on Ubuntu 22.04

While the snap package method is convenient, alternative methods exist for installing Wekan on Ubuntu 22.04. These methods offer greater control over the installation process and can be beneficial in specific environments. Here are two alternative approaches:

1. Installing Wekan using Docker

Docker provides a containerized environment that isolates Wekan and its dependencies from the host system. This approach simplifies deployment and management.

Explanation:

Docker containers encapsulate applications with all their dependencies, ensuring consistent behavior across different environments. This is especially useful when you want to avoid conflicts with other software on your server or need a repeatable deployment process.

Steps:

1. Install Docker and Docker Compose: If you haven’t already, install Docker and Docker Compose on your Ubuntu 22.04 server.

   sudo apt update
   sudo apt install docker.io docker-compose -y

2. Create a docker-compose.yml file: This file defines the services needed for Wekan (Wekan itself and MongoDB).

   version: "3.9"
   services:
     mongodb:
       image: mongo:latest
       restart: unless-stopped
       volumes:
         - mongo_data:/data/db
   
     wekan:
       image: quay.io/wekan/wekan:latest
       restart: unless-stopped
       ports:
         - "3001:3001"
       environment:
         MONGO_URL: mongodb://mongodb:27017/wekan
         ROOT_URL: http://your_server_ip:3001 # Replace with your server IP or domain
       depends_on:
         - mongodb
   
   volumes:
     mongo_data:

   Explanation of the docker-compose.yml file:

   • version: "3.9": Specifies the Docker Compose file version.
   • services:: Defines the services that make up the application.
     • mongodb:: Defines the MongoDB service.
       • image: mongo:latest: Uses the latest official MongoDB Docker image.
       • restart: unless-stopped: Restarts the container automatically unless it was explicitly stopped.
       • volumes: - mongo_data:/data/db: Mounts a named volume to persist MongoDB data.
     • wekan:: Defines the Wekan service.
       • image: quay.io/wekan/wekan:latest: Uses the latest official Wekan Docker image.
       • restart: unless-stopped: Restarts the container automatically unless it was explicitly stopped.
       • ports: - "3001:3001": Maps port 3001 on the host to port 3001 in the container.
       • environment:: Sets environment variables for the Wekan container.
         • MONGO_URL: mongodb://mongodb:27017/wekan: Specifies the MongoDB connection URL.
         • ROOT_URL: http://your_server_ip:3001: Sets the root URL for Wekan (replace with your server IP or domain).
       • depends_on: - mongodb: Ensures that the MongoDB container is started before the Wekan container.
   • volumes:: Defines named volumes for persistent data storage.
     • mongo_data:: Defines a named volume for MongoDB data.

3. Start the containers: Navigate to the directory containing the docker-compose.yml file and run:

   sudo docker-compose up -d

   This command starts the MongoDB and Wekan containers in detached mode (in the background).

4. Access Wekan: Open your web browser and navigate to http://your_server_ip:3001 (replace your_server_ip with your server’s actual IP address).

2. Manual Installation from Source

While more complex, manual installation from source provides the most control over the installation process and allows for advanced customization. This typically involves downloading the source code, installing dependencies, configuring the application, and running it. However, this method is significantly more involved and prone to errors. Due to the complexity and potential for dependency conflicts, providing a fully detailed guide for manual installation is beyond the scope of this article. It typically involves steps such as:

• Installing Meteor (the Javascript framework Wekan is built on)
• Downloading the Wekan source code from Github
• Installing all necessary Node.js packages
• Configuring the MongoDB connection
• Building and running the Wekan application

This method is recommended only for experienced users comfortable with the command line and debugging complex software installations. It also necessitates ongoing maintenance to keep Wekan up-to-date. The Docker installation is generally preferable to manual installation unless you have very specific customization needs.

In conclusion, while the snap package offers the simplest installation method for How To Install Wekan Server on Ubuntu 22.04, Docker provides a robust and portable alternative, and manual installation allows for ultimate control at the cost of increased complexity.

This article provides a comprehensive guide on How To Install Wekan Server on Ubuntu 22.04.