- \n
- CentOS 7 server<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do<\/h2>\n
- \n
- Install Nodejs<\/li>\n
- Install and Configure MongoDB<\/li>\n
- Install Wekan<\/li>\n
- Run Wekan as a Service on CentOS 7<\/li>\n
- Install and Configure Nginx as a Reverse Proxy for Wekan<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Install NodeJS using NVM Node Version Manager<\/h2>\n
Wekan is a nodejs-based application, and it requires the nodejs version 4.8. In this tutorial, we will not install nodejs from the CentOS repository, rather we will install nodejs 4.8 using the nvm Node Version Manager.<\/p>\n
Before installing nodejs, add new system user ‘wekan’ using the command below.<\/p>\n
useradd -m -s \/bin\/bash wekan
passwd wekan<\/p>\nLogin to the ‘wekan’ user, then download and run the nvm installer script.<\/p>\n
su – wekan
curl -o- https:\/\/raw.githubusercontent.com\/creationix\/nvm\/v0.33.8\/install.sh | bash<\/p>\n![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7.png\" "\\"\\"")
<\/a><\/p>\nThe command will install nvm under ‘wekan’ user and add new configuration to the ‘.bashrc’ configuration file. Now reload the ‘.bashrc’ file.<\/p>\n
source ~\/.bashrc<\/p>\n
Test using the nvm command as below.<\/p>\n
command -v nvm
nvm –version<\/p>\nNow you can see nvm ‘0.33.8’ installed on the system.<\/p>\n
Next, install nodejs 4.8 using the nvm command below.<\/p>\n
nvm install v4.8
nvm use node<\/p>\nAfter the installation is complete, check the node version.<\/p>\n
node -v<\/p>\n
And you will see the nodejs 4.8 is installed on the CentOS 7 server, under the ‘wekan’ user.<\/p>\n
![\"nodejs](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-1.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install and configure MongoDB<\/h2>\n
In this step, we will install MongoDB 3.2.x using the official repository, and then configure the basic security for MongoDB NoSQL database server.<\/p>\n
Go to the ‘\/etc\/yum.repos.d.\/ directory and create a new .repo file using the\u00a0vim<\/a> editor.<\/p>\n
cd \/etc\/yum.repos.d\/
vim mongodb-org-3.2.repo<\/p>\nPaste the following MongoDB repository there.<\/p>\n
[mongodb-org-3.2]
Save and exit.<\/p>\n
Now install MongoDB using the yum command below.<\/p>\n
yum -y install mongodb-org mongodb-org-server mongodb-org-shell mongodb-org-mongos mongodb-org-tools<\/p>\n
After the installation is complete, start the MongoDB service and enable it to launch at system boot.<\/p>\n
systemctl start mongod
systemctl enable mongod<\/p>\nMongoDB 3.2 has been installed on the CentOS 7 system.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-2.png\" "\\"\\"")
<\/a><\/p>\nNext, we need to configure the MongoDB authentication. Login to the mongo shell and create a new user named ‘admin’ for the superuser access.<\/p>\n
Login to the mongo shell.<\/p>\n
mongo<\/p>\n
Now create new ‘admin’ user with password ‘MyAdminPassword’ with role as ‘root’. Run the MongoDB queries below.<\/p>\n
db.createUser(
\u00a0 {
\u00a0\u00a0\u00a0 user: “admin”,
\u00a0\u00a0\u00a0 pwd: “MyAdminPassword”,
\u00a0\u00a0\u00a0 roles: [ { role: “root”, db: “admin” } ]
\u00a0 }
)<\/p>\nThe MongoDB admin user has been created.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-3.png\" "\\"\\"")
<\/a><\/p>\nNow we need to edit the configuration file ‘\/etc\/mongod.conf’ to enable the authentication.<\/p>\n
Edit the configuration file ‘mongod.conf’ using vim.<\/p>\n
vim \/etc\/mongod.conf<\/p>\n
Uncomment the ‘security’ line and add the configuration as shown below.<\/p>\n
security:
Save and exit.<\/p>\n
Now restart the MongoDB service.<\/p>\n
systemctl restart mongod<\/p>\n
The MongoDB authentication has been enabled.<\/p>\n
Next, we need to create a new database and user for Wekan. We will create a new database named ‘wekan’ with user ‘wekan’ and password ‘WekanPassword’.<\/p>\n
Login to the mongo shell as the admin user.<\/p>\n
mongo -u admin -p<\/p>\n
Type the admin password ‘MyAdminPassword’.<\/p>\n
And when you get the mongo shell, run the MongoDB queries below.<\/p>\n
use wekan
db.createUser(
\u00a0\u00a0\u00a0 {
\u00a0\u00a0\u00a0\u00a0\u00a0 user: “wekan”,
\u00a0\u00a0\u00a0\u00a0\u00a0 pwd: “WekanPassword”,
\u00a0\u00a0\u00a0\u00a0\u00a0 roles: [“readWrite”]
\u00a0\u00a0\u00a0 }
\u00a0)<\/p>\nThe database and user for wekan installation have been created.<\/p>\n
![\"User](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-4.png\" "\\"\\"")
<\/a><\/p>\nStep 3 – Install Wekan<\/h2>\n
Login as the wekan user.<\/p>\n
su – wekan<\/p>\n
Download wekan source code using the wget command and extract it.<\/p>\n
wget https:\/\/github.com\/wekan\/wekan\/releases\/download\/v0.63\/wekan-0.63.tar.gz
tar xf wekan-0.63.tar.gz<\/p>\nAnd you will get a new directory named ‘bundle’ – go to that directory and install the wekan dependencies using the npm command as shown below.<\/p>\n
cd bundle\/programs\/server
npm install<\/p>\nAfter all dependencies installation is complete, you will get the result as below.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-5.png\" "\\"\\"")
<\/a><\/p>\nNext, we will try to run Wekan on the system.<\/p>\n
Run the following commands to set up the environment variable for the Wekan application.<\/p>\n
export MONGO_URL=’mongodb:\/\/wekan:[email\u00a0protected]<\/a>:27017\/wekan?authSource=wekan’
export ROOT_URL=’http:\/\/192.168.33.10′
export MAIL_URL=’smtp:\/\/user:[email\u00a0protected]<\/a>:25\/’
export MAIL_FROM=’[email\u00a0protected]<\/a>‘
export PORT=8000<\/p>\nNow go to the ‘bundle’ directory and run the wekan application.<\/p>\n
cd ~\/bundle
node main.js<\/p>\n![\"Run](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-6.png\" "\\"\\"")
<\/a><\/p>\nWekan server is now running under port 8000. Open your web browser and type your server address with port 8000.<\/p>\n
http:\/\/192.168.33.10:8000\/<\/strong><\/em><\/p>\n
And you will get the Wekan login page as below.<\/p>\n
![\"Wekan](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-7.png\" "\\"\\"")
<\/a><\/p>\nWekan is now successfully installed on the CentOS 7 server.<\/p>\n
Step 4 – Running Wekan as a Service on CentOS 7<\/h2>\n
We will be running the wekan application as a service on Ubuntu system. So we need to create new service file under the systemd system directory.<\/p>\n
Before creating the wekan service file, we need to create the environment variable file.<\/p>\n
Login as the wekan user.<\/p>\n
su – wekan<\/p>\n
Go to the ‘bundle\/’ directory and create new environment variable file ‘.env’ using vim.<\/p>\n
cd bundle\/
vim .env<\/p>\nPaste the following configuration there.<\/p>\n
MONGO_URL='mongodb:\/\/wekan:[email\u00a0protected]<\/a>:27017\/wekan?authSource=wekan'
Save and exit.<\/p>\n
Next, come back to your root terminal.<\/p>\n
Go to the ‘\/etc\/systemd\/system’ directory and create new service file ‘wekan.service’.<\/p>\n
cd \/etc\/systemd\/system
vim wekan.service<\/p>\nPaste the following configuration there.<\/p>\n
[Unit]
[Service]
[Install]
Save and exit.<\/p>\n
Reload the systemd system using the systemctl command.<\/p>\n
systemctl daemon-reload<\/p>\n
Start the wekan service and enable it launch everytime at system boot.<\/p>\n
systemctl start wekan
systemctl enable wekan<\/p>\nNow check the wekan service using commands below.<\/p>\n
netstat -plntu
systemctl status wekan<\/p>\nAnd following is the result in our case.<\/p>\n
![\"Run](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-8.png\" "\\"\\"")
<\/a><\/p>\nWekan is now running as a service under port 8000 on a CentOS 7 system.<\/p>\n
Step 5 – Install and Configure Nginx as a Reverse Proxy for Wekan<\/h2>\n
In this step, we will install Nginx web server and configure it as a reverse proxy for the wekan service that’s running under port 8000.<\/p>\n
Before installing the Nginx web server, add new EPEL (Extra Package for Enterprise Linux) repository.<\/p>\n
yum -y install epel-release<\/p>\n
Now install nginx from the epel repository using the yum command below.<\/p>\n
yum -y install nginx<\/p>\n
After the installation is complete, go to the ‘\/etc\/nginx\/’ configuration directory and create new virtual host file ‘wekan.conf’ under the ‘conf.d’ directory.<\/p>\n
cd \/etc\/nginx
vim conf.d\/wekan.conf<\/p>\nPaste the following virtual host configuration there.<\/p>\n
server {\u00a0\u00a0\u00a0 access_log \/var\/log\/nginx\/wekan-access.log;
\u00a0\u00a0\u00a0 location \/ {
Save and exit.<\/p>\n
Test nginx configuration and make sure there is no error.<\/p>\n
nginx -t<\/p>\n
If there is no error, start the Nginx service and enable it to launch at system boot.<\/p>\n
systemctl start nginx
systemctl enable nginx<\/p>\nNow check the HTTP port using the netstat command, and make sure it is on the ‘LISTEN’ state.<\/p>\n
netstat -plntu<\/p>\n
The Nginx virtual host configuration for Wekan has been completed.<\/p>\n
![\"Nginx](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-9.png\" "\\"\\"")
<\/a><\/p>\nStep 6 – Testing<\/h2>\n
Open your web browser and type the wekan url installation in the address bar.<\/p>\n
http:\/\/wekan.hakase-labs.co\/<\/strong><\/em><\/p>\n
And you will be redirected to the login page – click on the ‘Register’ link.<\/p>\n
![\"Login](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-10.png\" "\\"\\"")
<\/a><\/p>\nNow type your username, email, password, and leave Invitation Code blank.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-11.png\" "\\"\\"")
<\/a><\/p>\nClick the blue ‘Register’ button.<\/p>\n
And you will get the ‘Internal Server Error’ message. Leave it and come back to your terminal. Because we will activate the first user from the terminal.<\/p>\n
Open your terminal and log in to the mongo shell as a ‘wekan’ user.<\/p>\n
mongo -u wekan -p –authenticationDatabase “wekan”<\/p>\n
Now activate the user using queries below.<\/p>\n
use wekan
db.users.update({username:’hakase’},{$set:{isAdmin:true}})<\/p>\nExit from the mongo shell.<\/p>\n
![\"Exit](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-12.png\" "\\"\\"")
<\/a><\/p>\nBack to your browser and open again the Wekan url installation.<\/p>\n
http:\/\/wekan.hakase-labs.co\/<\/strong><\/em><\/p>\n
Type your username and password, then click the ‘Sign In’ button.<\/p>\n
![\"Wekan](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-13.png\" "\\"\\"")
<\/a><\/p>\nAnd you will get the Wekan user dashboard.<\/p>\n
![\"Wekan](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-14.png\" "\\"\\"")
<\/a><\/p>\nBelow is the wekan sample project.<\/p>\n
![\"Wekan](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-15.png\" "\\"\\"")
<\/a><\/p>\nWekan installation on CentOS 7 system with MongoDB and Nginx web server has been completed successfully.<\/p>\n
Reference<\/h2>\n
\nShare this page:<\/b><\/p>\n
\n
![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-16.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-17.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-18.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-and-configure-wekan-trello-like-kanban-on-centos-7-19.png\" "\\"\\"")
<\/a>\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"Wekan is an open source Trello-like kanban board based on the Meteor Javascript framework. It’s a web-based management tool that allows you to create a board for your project collaboration. With the wekan board, you just need to invite a member to the board and you’re good to go. On the wekan board, you can […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36],"tags":[],"class_list":["post-5226","post","type-post","status-publish","format-standard","hentry","category-36"],"_links":{"self":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/5226","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/comments?post=5226"}],"version-history":[{"count":0,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/5226\/revisions"}],"wp:attachment":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/media?parent=5226"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/categories?post=5226"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/tags?post=5226"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"Install](\"https:\/\/www.howtoforge.com\/images\/how_to_install_and_configure_wekan_trello_like_kanban_on_centos_7\/big\/11.png\" "\\"\\"")
<\/a><\/p>\n