NOTE<\/strong>:\u00a0Installing NodeBB’s dependencies may require more than 512 megabytes of system memory. It is recommended to\u00a0enable a swap partition\u00a0to compensate if your Linux system has insufficient memory.<\/em><\/p>\n Check\u00a0your\u00a0Fedora version:<\/p>\n Set up the timezone:<\/p>\n Update your operating system packages (software). This is an important first step because it ensures you have the latest updates and security fixes for your operating system’s default software packages:<\/p>\n Install some essential packages that are\u00a0necessary for basic administration of\u00a0the Fedora operating system:<\/p>\n For simplicity’s sake, disable SELinux and Firewall:<\/p>\n NodeBB is built on\u00a0Node.js.\u00a0We are going to install\u00a0recommended<\/strong>\u00a0version for\u00a0NodeBB which is\u00a0version 8\u00a0<\/b>at the time of this writing. On Linux, you have a few Node.js installation options: Linux Binaries (x86\/x64), Source Code or via Package Managers. We will use Package Management option which makes installing and updating Node.js a breeze.<\/p>\n Download and install the latest Long-Term Support (LTS) release of\u00a0Node.js from the\u00a0Fedora repo:<\/p>\n To compile and install native add-ons from npm you may also need to install build tools:<\/p>\n NOTE<\/strong>:\u00a0npm is distributed with Node.js – which means that when you download Node.js, you automatically get npm installed on your system. Check the Node.js and\u00a0npm\u00a0versions:<\/p>\n Npm is a separate project from Node.js, and tends to update more frequently. As a result, even if you\u2019ve just downloaded Node.js (and therefore npm), you\u2019ll probably need to update your npm. Luckily, npm knows how to update itself! To update your npm, type this into your terminal:<\/p>\n This command will update npm to the latest stable version.<\/p>\n Re-check npm version with:<\/p>\n And it should return latest version numbers.<\/p>\n NodeBB needs a database to store its data, and it supports MongoDB and Redis. In this tutorial, we\u00a0chose MongoDB as data store engine. So, in the next few steps, we will download and install MongoDB database from the official MongoDB rpm repository:<\/p>\n To install the stable version of MongoDB package, issue the following command:<\/p>\n Check the MongoDB version:<\/p>\n Start\u00a0and\u00a0enable\u00a0(set it to start on reboot<\/em>)\u00a0MongoDB service:<\/p>\n Check the MongoDB Database Server status by running:<\/p>\n Next, create MongoDB database and user for NodeBB.<\/p>\n Connect to MongoDB server first.<\/p>\n Switch to the built-in\u00a0 Create an administrative user.<\/p>\n NOTE:<\/strong>\u00a0Replace the placeholder\u00a0 Add a new database called\u00a0 The database will be created and context switched to\u00a0 NOTE:<\/strong>\u00a0Again, replace the placeholder\u00a0 Exit the Mongo shell.<\/p>\n Restart MongoDB and verify that the administrative user created earlier can connect.<\/p>\n If all went well, your MongoDB should be installed and prepared for NodeBB. In the next\u00a0step, we will deal with web server installation and configuration.<\/p>\n Securing your\u00a0NodeBB Forum with HTTPS is not necessary, but it is a good practice to secure your site traffic. In order to obtain\u00a0TLS certificate from Let’s Encrypt we will use acme.sh client. Acme.sh is a pure unix shell software for obtaining\u00a0TLS certificates from Let’s Encrypt with zero dependencies.<\/p>\n Download and install\u00a0acme.sh:<\/p>\n Check acme.sh\u00a0version:<\/p>\n Obtain\u00a0RSA<\/strong>\u00a0and\u00a0ECC\/ECDSA<\/strong>\u00a0certificates for your\u00a0domain\/hostname: If you want fake certificates for testing you can add\u00a0 After running the above commands, your\u00a0certificates<\/em>\u00a0and\u00a0keys<\/em>\u00a0will be in:<\/p>\n To list your issued certs you can run:<\/p>\n Create a\u00a0directories\u00a0to store your certs. We will use\u00a0 Install\/copy certificates to\u00a0\/etc\/letsencrypt\u00a0directory.<\/p>\n All the\u00a0certificates will be automatically renewed every 60 days.<\/p>\n After obtaining certs exit from root user and return back to normal sudo user:<\/p>\n NodeBB\u00a0can work fine with many web servers. In this tutorial, we selected Nginx.<\/p>\n Install Nginx package, by issue the following command:<\/p>\n After the installation, you can\u00a0verify\u00a0Nginx version by running:<\/p>\n Start\u00a0and\u00a0enable (set it to start on reboot<\/em>) Nginx service:<\/p>\n Check the\u00a0Nginx\u00a0web server status by running:<\/p>\n NodeBB by default runs on port\u00a0 Run\u00a0 Check the Nginx configuration:<\/p>\n Finally, for\u00a0changes to take effect, we need to reload Nginx:<\/p>\n Create a document root directory where\u00a0NodeBB should reside in:<\/p>\n Navigate to the document root directory:<\/p>\n Change ownership of the\u00a0 NOTE:\u00a0<\/strong>Replace your_user in the above command with your non-root user that you should have created as a prerequisite for this tutorial<\/em>.<\/em><\/p>\n Clone the latest NodeBB\u00a0repository\u00a0into document root folder:<\/p>\n Initiate the setup script by running the app with the\u00a0 After NodeBB setup is completed, run\u00a0 After running this command, you should be able to access your brand new forum in your web browser:<\/p>\n <\/a> When started via\u00a0 If running, stop NodeBB:<\/p>\n Create a new\u00a0 Change the ownership of the\u00a0 Create\u00a0 NOTE:<\/strong>\u00a0Set username and directory paths according to your chosen names.<\/em><\/p>\n Enable\u00a0 Check the\u00a0 Congratulations! You have successfully installed and deployed\u00a0NodeBB\u00a0discussion platform on Fedora 29 system.\u00a0You should be able to access your forum on your domain\u00a0and interact with your forum.<\/p>\nPrerequisites<\/h2>\n
\n
A<\/code>\/AAAA<\/code>\u00a0records set up.<\/li>\nInitial steps<\/h2>\n
cat \/etc\/fedora-release\r\n#\u00a0Fedora release 29 (Twenty Nine)<\/code><\/pre>\ntimedatectl list-timezones\r\nsudo timedatectl set-timezone 'Region\/City'<\/code><\/pre>\nsudo dnf check-upgrade || sudo dnf upgrade -y<\/code><\/pre>\nsudo dnf install -y curl wget vim\u00a0bash-completion git socat<\/code><\/pre>\nsudo setenforce 0; sudo systemctl stop firewalld.service; sudo systemctl disable firewalld.service<\/code><\/pre>\nStep 1: Install Node.js and npm<\/h2>\n
sudo dnf -y install nodejs<\/code><\/pre>\nsudo dnf install -y gcc-c++ make\r\n# or\r\n# sudo dnf groupinstall -y 'Development Tools'<\/code><\/pre>\n
\n<\/em><\/p>\nnode -v && npm -v\r\n# v10.15.0\r\n# 6.4.1<\/code><\/pre>\nsudo npm install -g npm@latest<\/code><\/pre>\nnpm -v\r\n# 6.7.0\r\n<\/code><\/pre>\nStep 2: Install and configure MongoDB<\/h2>\n
sudo dnf install -y mongodb mongodb-server<\/code><\/pre>\nmongo --version | head -n 1 && mongod --version | head -n 1\r\n# MongoDB shell version v4.0.1\r\n# db version v4.0.1<\/code><\/pre>\nsudo systemctl start mongod.service\r\nsudo systemctl enable mongod.service<\/code><\/pre>\nsudo systemctl status mongod.service\r\n#\u00a0active (running)<\/code><\/pre>\nmongo<\/code><\/pre>\nadmin<\/code>\u00a0database.<\/p>\n> use admin<\/code><\/pre>\n> db.createUser( { user: \"admin\", pwd: \"<Enter a secure password>\", roles: [ { role: \"readWriteAnyDatabase\", db: \"admin\" }, { role: \"userAdminAnyDatabase\", db: \"admin\" } ] } )<\/code><\/pre>\n<Enter a secure password><\/code>\u00a0with your own selected password.<\/em><\/p>\nnodebb<\/code>.<\/p>\n> use nodebb<\/code><\/pre>\nnodebb<\/code>. Next create the\u00a0nodebb<\/code>\u00a0user with the appropriate privileges.<\/p>\n> db.createUser( { user: \"nodebb\", pwd: \"<Enter a secure password>\", roles: [ { role: \"readWrite\", db: \"nodebb\" }, { role: \"clusterMonitor\", db: \"admin\" } ] } )<\/code><\/pre>\n<Enter a secure password><\/code>\u00a0with your own selected password.<\/em><\/p>\n> quit()<\/code><\/pre>\nsudo systemctl restart mongod.service\r\nmongo -u admin -p your_password --authenticationDatabase=admin<\/code><\/pre>\nStep 3 – Install\u00a0
acme.sh<\/code>\u00a0client and obtain Let’s Encrypt certificate (optional<\/em>)<\/h2>\nsudo su - root\r\ngit clone https:\/\/github.com\/Neilpang\/acme.sh.git\r\ncd acme.sh\u00a0\r\n.\/acme.sh --install --accountemail\u00a0your_email@example.com\r\nsource ~\/.bashrc\r\ncd ~<\/code><\/pre>\nacme.sh --version\r\n# v2.8.0<\/code><\/pre>\n
\n<\/code><\/p>\n# RSA 2048\r\nacme.sh --issue\u00a0--standalone -d example.com --keylength 2048\r\n# ECDSA\r\nacme.sh --issue --standalone -d example.com --keylength ec-256<\/code><\/pre>\n--staging<\/code>\u00a0flage to the above commands.<\/p>\n\n
\/home\/username\/example.com<\/code>\u00a0directory.<\/li>\n\/home\/username\/example.com_ecc<\/code>\u00a0directory.<\/li>\n<\/ul>\nacme.sh --list<\/code><\/pre>\n\/etc\/letsencrypt<\/code>\u00a0directory.<\/p>\nmkdir -p \/etc\/letsecnrypt\/example.com<\/code>\r\nsudo mkdir -p \/etc\/letsencrypt\/example.com_ecc<\/code><\/pre>\n# RSA\r\nacme.sh --install-cert -d example.com --cert-file \/etc\/letsencrypt\/example.com\/cert.pem --key-file \/etc\/letsencrypt\/example.com\/private.key --fullchain-file \/etc\/letsencrypt\/example.com\/fullchain.pem --reloadcmd \"sudo systemctl reload nginx.service\"\r\n# ECC\/ECDSA\r\nacme.sh --install-cert -d example.com --ecc --cert-file \/etc\/letsencrypt\/example.com_ecc\/cert.pem --key-file \/etc\/letsencrypt\/example.com_ecc\/private.key --fullchain-file \/etc\/letsencrypt\/example.com_ecc\/fullchain.pem --reloadcmd \"sudo systemctl reload nginx.service\"<\/code><\/pre>\nexit<\/code><\/pre>\nStep 4: Install and configure Nginx<\/h2>\n
sudo dnf install -y nginx<\/code><\/pre>\nnginx -v\r\n# 1.14.1<\/code><\/pre>\nsudo systemctl start nginx.service\r\nsudo systemctl enable nginx.service<\/code><\/pre>\nsudo systemctl status nginx.service\r\n#\u00a0active (running)<\/code><\/pre>\n4567<\/code>. To avoid typing\u00a0http:\/\/example.com:4567<\/code>, we will configure Nginx as a reverse proxy for the NodeBB application. Every request on port\u00a080<\/code>\u00a0or\u00a0443<\/code>\u00a0(if SSL is used<\/em>) will be forwarded to port\u00a04567<\/code>.<\/p>\nsudo vim \/etc\/nginx\/conf.d\/nodebb.conf<\/code>\u00a0and configure Nginx as an HTTPS reverse proxy.<\/p>\nserver {\r\n listen [::]:443 ssl http2;\r\n listen 443 ssl http2;\r\n listen [::]:80;\r\n listen 80;\r\n \r\n server_name forum.example.com;\r\n \r\n client_max_body_size 50M;\r\n\r\n # RSA\r\n ssl_certificate \/etc\/letsencrypt\/example.com\/fullchain.pem;\r\n ssl_certificate_key \/etc\/letsencrypt\/example.com\/private.key;\r\n # ECDSA\r\n ssl_certificate \/etc\/letsencrypt\/example.com_ecc\/fullchain.pem;\r\n ssl_certificate_key \/etc\/letsencrypt\/example.com_ecc\/private.key;\r\n\r\n location \/ {\r\n proxy_set_header X-Real-IP $remote_addr;\r\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n proxy_set_header X-Forwarded-Proto $scheme;\r\n proxy_set_header Host $http_host;\r\n proxy_set_header X-NginX-Proxy true;\r\n proxy_pass http:\/\/127.0.0.1:4567;\r\n proxy_redirect off;\r\n # Socket.IO Support\r\n proxy_http_version 1.1;\r\n proxy_set_header Upgrade $http_upgrade;\r\n proxy_set_header Connection \"upgrade\"; \r\n }\r\n\r\n}<\/code><\/pre>\nsudo nginx -t<\/code><\/pre>\nsudo systemctl reload nginx.service<\/code><\/pre>\nStep 5: Install and setup NodeBB<\/h2>\n
sudo mkdir -p \/var\/www\/nodebb<\/code><\/pre>\ncd \/var\/www\/nodebb<\/code><\/pre>\n\/var\/www\/nodebb<\/code>\u00a0directory to\u00a0your_user.<\/p>\nsudo chown -R [your_user]:[your_user] \/var\/www\/nodebb<\/code><\/pre>\ngit clone -b v1.11.x https:\/\/github.com\/NodeBB\/NodeBB.git .<\/code><\/pre>\nsetup<\/code>\u00a0flag. Answer each of the questions:<\/p>\n.\/nodebb setup<\/code><\/pre>\n.\/nodebb start<\/code>\u00a0to manually start your NodeBB server:<\/p>\n.\/nodebb start<\/code><\/pre>\n![\"NodeBB](\"https:\/\/www.howtoforge.com\/images\/how_to_install_nodebb_forum_on_centos_7\/big\/Screen_Shot_2018-09-21_at_5.27_.16_AM_.png\")
<\/a><\/p>\nStep 6: Run NodeBB as a System Service<\/h2>\n
.\/nodebb start<\/code>, NodeBB will not automatically start up again when the system reboots. To avoid that, we will need to setup NodeBB as a system service.<\/p>\n.\/nodebb stop<\/code><\/pre>\nnodebb<\/code>\u00a0user:<\/p>\nsudo useradd nodebb<\/code><\/pre>\n\/var\/www\/nodebb<\/code>\u00a0directory to\u00a0nodebb<\/code>\u00a0user:<\/p>\nsudo chown -R nodebb:nodebb \/var\/www\/nodebb<\/code><\/pre>\nnodebb.service<\/code>\u00a0systemd unit config file. This unit file will handle startup of NodeBB deamon. Run\u00a0sudo vim \/etc\/systemd\/system\/nodebb.service<\/code>\u00a0and\u00a0add the below content:<\/p>\n[Unit]\r\nDescription=NodeBB\r\nDocumentation=https:\/\/docs.nodebb.org\r\nAfter=system.slice multi-user.target mongod.service\r\n\r\n[Service]\r\nType=forking\r\nUser=nodebb\r\n\r\nStandardOutput=syslog\r\nStandardError=syslog\r\nSyslogIdentifier=nodebb\r\n\r\nEnvironment=NODE_ENV=production\r\nWorkingDirectory=\/var\/www\/nodebb\r\nPIDFile=\/var\/www\/nodebb\/pidfile\r\nExecStart=\/usr\/bin\/env node loader.js\r\nRestart=always\r\n\r\n[Install]\r\nWantedBy=multi-user.target\r\n<\/code><\/pre>\nnodebb.service<\/code>\u00a0on reboot and immediately start\u00a0nodebb.service:<\/code><\/p>\nsudo systemctl enable nodebb.service\r\nsudo systemctl start nodebb.service<\/code><\/pre>\nnodebb.service<\/code>\u00a0status:<\/p>\nsudo systemctl status nodebb.service\r\nsudo systemctl is-enabled nodebb.service<\/code><\/pre>\nLinks<\/h2>\n
\n