{"id":2051,"date":"2025-11-26T08:58:59","date_gmt":"2023-07-19T12:16:17","guid":{"rendered":""},"modified":"2025-02-02T00:46:18","modified_gmt":"2025-02-01T23:46:18","slug":"how-to-install-wiki-js-with-apache2-reverse-proxy-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-wiki-js-with-apache2-reverse-proxy-on-ubuntu-22-04\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Wiki.js with Apache2 Reverse Proxy on Ubuntu 22.04"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

Wiki.js<\/strong> is a powerful, open-source wiki engine that supports Markdown and offers a user-friendly interface for managing documentation and collaboration. In this guide, we will show you how to install Wiki.js on Ubuntu 22.04<\/strong> and configure Apache2 as a reverse proxy. Hosting your Wiki.js instance on a provides the necessary resources and performance required to run a high-traffic wiki, offering enhanced control, scalability, and security with a VPS server<\/strong>.<\/p>\n

Step 1: Update Your VPS Server<\/h2>\n

Before starting the installation process, make sure your VPS server<\/a> is updated. Run the following commands to ensure your system is up to date:<\/p>\n

sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n
By hosting your Wiki.js instance on a Windows VPS<\/strong>, you can take advantage of dedicated resources that ensure a smooth and fast experience for your users.<\/p>\n
Step 2: Install Node.js<\/h2>\n
Wiki.js is built on Node.js, so you need to install it before setting up Wiki.js. Install Node.js by running the following commands:<\/p>\n
\r\ncurl -fsSL https:\/\/deb.nodesource.com\/setup_18.x | sudo -E bash -\r\nsudo apt install nodejs -y\r\n<\/code><\/pre>\n
After the installation, verify that Node.js is installed correctly by checking the version:<\/p>\n
node -v<\/code><\/pre>\n
Step 3: Install MongoDB<\/h2>\n
Wiki.js uses MongoDB to store its data. Install MongoDB using the following commands:<\/p>\n
\r\nsudo apt install mongodb -y\r\nsudo systemctl enable mongodb --now\r\n<\/code><\/pre>\n
To verify that MongoDB is running, use the following command:<\/p>\n
sudo systemctl status mongodb<\/code><\/pre>\n
Step 4: Install Wiki.js<\/h2>\n
Now that the dependencies are installed, you can proceed with the installation of Wiki.js. First, create a directory for Wiki.js and navigate to it:<\/p>\n
sudo mkdir -p \/var\/www\/wiki && cd \/var\/www\/wiki<\/code><\/pre>\n
Download and extract the latest version of Wiki.js:<\/p>\n
\r\nwget https:\/\/github.com\/Requarks\/wiki\/releases\/latest\/download\/wiki-js.tar.gz\r\ntar xzf wiki-js.tar.gz\r\nrm wiki-js.tar.gz\r\n<\/code><\/pre>\n
Next, configure Wiki.js by creating the configuration file:<\/p>\n
cp config.sample.yml config.yml<\/code><\/pre>\n
Edit the config.yml<\/code> file to set up your MongoDB connection and any other necessary configurations. Use the following command to open the file:<\/p>\n
sudo nano config.yml<\/code><\/pre>\n
Once the configuration is set, start Wiki.js using the following command:<\/p>\n
node server<\/code><\/pre>\n
Step 5: Set Up Apache2 as a Reverse Proxy<\/h2>\n
To access Wiki.js via a domain or IP address, configure Apache2 as a reverse proxy. First, install Apache2:<\/p>\n
sudo apt install apache2 -y<\/code><\/pre>\n
Enable the necessary Apache modules:<\/p>\n
\r\nsudo a2enmod proxy\r\nsudo a2enmod proxy_http\r\nsudo a2enmod rewrite\r\n<\/code><\/pre>\n
Next, create a new virtual host configuration file for Wiki.js:<\/p>\n
sudo nano \/etc\/apache2\/sites-available\/wiki.conf<\/code><\/pre>\n
Add the following configuration, replacing your-domain.com<\/code> with your actual domain or server IP address:<\/p>\n
\r\n\r\n    ServerAdmin admin@your-domain.com\r\n    ServerName your-domain.com\r\n\r\n    ProxyPass \/ http:\/\/localhost:3000\/\r\n    ProxyPassReverse \/ http:\/\/localhost:3000\/\r\n\r\n    ErrorLog ${APACHE_LOG_DIR}\/wiki-error.log\r\n    CustomLog ${APACHE_LOG_DIR}\/wiki-access.log combined\r\n\r\n<\/code><\/pre>\n
Enable the virtual host and restart Apache:<\/p>\n
\r\nsudo a2ensite wiki.conf\r\nsudo systemctl restart apache2\r\n<\/code><\/pre>\n
Step 6: Access Wiki.js<\/h2>\n
Once the configuration is complete, you can access Wiki.js by navigating to http:\/\/your-domain.com<\/code> in your web browser. You will be taken to the initial setup screen where you can configure the admin account, connect to MongoDB, and finalize your Wiki.js setup.<\/p>\n
Step 7: Secure Wiki.js with SSL (Optional)<\/h2>\n
For better security, it’s a good idea to secure your Wiki.js instance with SSL using Let’s Encrypt. Install Certbot by running:<\/p>\n
sudo apt install certbot python3-certbot-apache -y<\/code><\/pre>\n
Run the following command to obtain and configure an SSL certificate for your domain:<\/p>\n
sudo certbot --apache -d your-domain.com<\/code><\/pre>\n
Follow the on-screen instructions to complete the SSL setup. Once finished, your Wiki.js site will be accessible via HTTPS.<\/p>\n
Step 8: Optimize Your VPS Server for Wiki.js<\/h2>\n
To ensure that your Wiki.js instance performs optimally, hosting it on a  is the best option. A VPS server<\/strong> offers dedicated resources, allowing your wiki to handle high traffic, serve content quickly, and scale as needed. A VPS also provides you with full control over your server, enabling you to tailor it to your specific project requirements.<\/p>\n
Conclusion<\/h2>\n
Installing Wiki.js with Apache2 reverse proxy on Ubuntu 22.04 provides a powerful and efficient solution for managing your documentation and collaboration needs. By hosting your Wiki.js installation on a , you gain enhanced performance, scalability, and security, ensuring that your wiki can grow as your needs evolve.<\/p>\n
For more information on VPS hosting and optimizing your Wiki.js setup, visit  today.<\/p>\n<\/article>\n