WeKan

Open-source kanban board app built with Meteor, free and MIT-licensed.

Access Wekan

  • Open your browser and go to: http://<SERVER_IP> (HTTP)
  • Register your username, email address and password.
  • First registered user will be admin, and next ones normal users.
  • During registration, you may see an “Internal Server Error” because email is not configured, but the user is still created and you can log in normally.
  • If you want to disable self-registration, go to Admin Panel → Settings and check “Disable Self Registration”.

Important Paths

  • Install directory: /root/wekan
  • Compose file: /root/wekan/docker-compose.yml
  • File uploads: /var/lib/docker/volumes/wekan_wekan-files/_data
  • Database: /var/lib/docker/volumes/wekan_wekan-db/_data
  • NGINX config: /etc/nginx/sites-available/wekan
  • NGINX enabled site: /etc/nginx/sites-enabled/wekan

Common Commands

Navigate to project:

cd /opt/wekan

View logs:

docker compose logs -f

Restart services:

docker compose restart

Stop / Start:

docker compose down
docker compose up -d

Check containers:

docker ps

Enable Email (Optional)

Edit:

/root/wekan/docker-compose.yml

Uncomment and configure:

MAIL_URL=smtp://<mail_url>:25/?ignoreTLS=true&tls={rejectUnauthorized:false}
MAIL_FROM=Wekan Notifications <[email protected]>

Then apply:

docker compose up -d

Enabling SSL with a Domain

1. Point your domain to the server IP.

2. Edit docker-compose.yml to set your domain as ROOT_URL: ROOT_URL=https://your.domain.com

3. Recreate the services:

cd /root/wekan/
docker compose up -d

3. Edit Nginx config and replace server_name _; with your domain (server_name <your-domain>;):

vim /etc/nginx/sites-available/wekan

4. Install Certbot:

apt install -y certbot python3-certbot-nginx

5. Run the following command to generate a valid Let’s Encrypt certificate:

certbot --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

6. Restart Nginx to apply the changes:

systemctl restart nginx

7. Open your browser and visit: https://yourdomain.com

Application Details