XWiki is a powerful and versatile wiki software that allows users to collaborate more efficiently. It offers a wide range of features, including WYSIWYG editing, document import/export, semantic annotations, and advanced permissions management. In this article, we will guide you through the process of installing XWiki on your Ubuntu 22.04 server.

Prerequisites

Before we begin, make sure you have the following prerequisites in place:

1. A server running Ubuntu 22.04.
2. A valid domain name pointed to your server IP.
3. A root password configured on the server.

Getting Started

Let’s start by updating and upgrading all system packages to the latest version. Open your terminal and run the following commands:

apt update -y
apt upgrade -y

Once the packages are updated, we can proceed with installing the necessary dependencies. Run the following command:

apt-get install wget curl unzip git name gnupg2 -y

Install Java JDK

XWiki is a Java-based application, so we need to install Java on our server. Execute the following command to install Java:

apt-get install default-jdk -y

To verify the Java version, use the following command:

java --version

Make sure you have OpenJDK version 11 or higher installed.

Add XWiki Repository

By default, the XWiki package is not included in the Ubuntu default repository. We need to add the XWiki official repository to our server. Run the following commands:

wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg
wget"https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list
apt-get update -y

Now that the XWiki repository is added, we can proceed with the installation.

Install XWiki on Ubuntu 22.04

Let’s install XWiki by executing the following command:

apt-get install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y

During the installation, you will be prompted to configure the database. Choose “Yes” and set a MySQL password for XWiki.

After the installation is complete, we can verify the status of the Tomcat service using the following command:

systemctl status tomcat9.service

Make sure the service is active and running.

Configure Nginx as a Reverse Proxy

To access XWiki via port 80, we will configure Nginx as a reverse proxy. Start by installing the Nginx package:

apt-get install nginx -y

Once Nginx is installed, create an Nginx configuration file by running the following command:

nano /etc/nginx/conf.d/xwiki.conf

In the file, add the following configuration:

server {
listen 80;

server_name xwiki.example.com;

access_log /var/log/nginx/xwiki-access.log;
error_log /var/log/nginx/xwiki-error.log;

location / {
proxy_set_header   X-Real-IP $remote_addr;
proxy_set_header   Host      $host;
proxy_http_version 1.1;
proxy_set_header   Upgrade $http_upgrade;
proxy_set_header   Connection 'upgrade';
proxy_cache_bypass $http_upgrade;
proxy_pass         http://127.0.0.1:8080;
}

}

Save and close the file. Restart the Nginx service to apply the changes:

systemctl restart nginx

You can verify the status of Nginx using the following command:

systemctl status nginx

Perform XWiki Web Installation

Now that everything is set up, open your web browser and access the XWiki web installation wizard using the URL http://xwiki.example.com/xwiki/bin/view/Main/. You should see the XWiki installation screen.

Click on the “Continue” button and proceed with the registration process. Enter your name, admin username, password, and email. Click on the “Register and login” button.

Next, you will be prompted to select the XWiki flavor. Choose your desired flavor and click on the “Install this flavor” button.

After the installation is complete, you will see the final installation screen. Click on the “Continue” button to access the XWiki dashboard.

Conclusion

Congratulations! You have successfully installed XWiki with Nginx on your Ubuntu 22.04 server. You can now start deploying your own wiki application using XWiki. If you have any questions or need further assistance, feel free to reach out.

To enhance your XWiki experience, consider leveraging the flexible and reliable Linux SSD VPS hosting services provided by Shape.host. Shape.host offers scalable and secure cloud hosting solutions, empowering businesses with efficient and cost-effective hosting options. Get started with Shape.host today and take your XWiki installation to the next level.

Christian Wells