Setting Up WeKan with LEMP Stack on Rocky Linux 8

#### Prerequisites Before you begin, ensure you have: - A server running Rocky Linux 8 (This guide is tested with Rocky Linux 8) - LEMP stack installed (Nginx, MariaDB, PHP) - A user account with sudo privileges - Basic familiarity with the command line #### Step 1: Install Nginx Web Server Ensure your system's package list is up-to-date, then install Nginx: ```bash sudo dnf update sudo dnf install nginx ``` Start and enable Nginx to run on system boot: ```bash sudo systemctl start nginx sudo systemctl enable nginx ``` #### Step 2: Install MariaDB Database Server Install MariaDB and secure the installation: ```bash sudo dnf install mariadb-server sudo systemctl start mariadb sudo systemctl enable mariadb sudo mysql_secure_installation ``` #### Step 3: Install PHP and Required Extensions Install PHP along with necessary PHP extensions for Nginx: ```bash sudo dnf install php php-fpm php-mysqlnd php-json php-mbstring php-gd php-xml ``` Start and enable PHP-FPM to handle PHP files: ```bash sudo systemctl start php-fpm sudo systemctl enable php-fpm ``` #### Step 4: Create a MariaDB Database and User for WeKan Log into MariaDB as the root user: ```bash sudo mysql -u root -p ``` Create a new database and user for WeKan: ```sql CREATE DATABASE wekan_db; CREATE USER 'wekan_user'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON wekan_db.* TO 'wekan_user'@'localhost'; FLUSH PRIVILEGES; EXIT; ``` #### Step 5: Install Node.js and npm Install Node.js and npm for WeKan: ```bash sudo dnf install nodejs npm ``` #### Step 6: Install WeKan Clone WeKan repository from GitHub: ```bash cd /var/www/html sudo git clone https://github.com/wekan/wekan.git cd wekan sudo npm install ``` #### Step 7: Configure WeKan Create a settings file and configure WeKan: ```bash sudo cp /var/www/html/wekan/env.default /var/www/html/wekan/env sudo nano /var/www/html/wekan/env ``` Update database connection details (`MONGO_URL`) in the `env` file with MariaDB settings. #### Step 8: Configure Nginx for WeKan Create a new Nginx server block configuration file for WeKan: ```bash sudo nano /etc/nginx/conf.d/wekan.conf ``` Add the following configuration (adjust paths and settings as necessary): ```nginx server { listen 80; server_name your_domain.com; root /var/www/html/wekan; index index.html index.htm; location / { proxy_pass http://localhost:4000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; } } ``` Save and close the file. Test Nginx configuration: ```bash sudo nginx -t sudo systemctl restart nginx ``` #### Step 9: Access WeKan Open your web browser and navigate to your domain name. You should see the WeKan login or registration page. Follow on-screen instructions to create an account and start using WeKan for project management. #### Conclusion You have successfully set up WeKan with the LEMP stack on Rocky Linux 8. Collaborate effectively with your team using WeKan's Kanban board for project organization and management. **Additional Resources:** - **WeKan Documentation:** [https://wekan.github.io/](https://wekan.github.io/) - **Rocky Linux Documentation:** [https://docs.rockylinux.org/](https://docs.rockylinux.org/) - **LEMP Stack Installation Guide:** [https://docs.rockylinux.org/guides/lemp-stack](https://docs.rockylinux.org/guides/lemp-stack)