{"id":2883,"date":"2025-12-03T15:47:55","date_gmt":"2024-07-09T12:11:25","guid":{"rendered":""},"modified":"2025-02-02T00:46:19","modified_gmt":"2025-02-01T23:46:19","slug":"how-to-install-xwiki-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-xwiki-on-ubuntu-22-04\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 XWiki on Ubuntu 22.04"},"content":{"rendered":"

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

\n

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

XWiki is an open-source enterprise wiki platform that allows teams to collaborate and share knowledge efficiently. This guide will walk you through the steps to install XWiki on Ubuntu 22.04. Whether you’re hosting XWiki on a local server or using a VPS solution such as , this tutorial will help you get started.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before installing XWiki, it’s essential to ensure your Ubuntu system is up-to-date. Run the following commands to update the system:<\/p>\n

sudo apt update && sudo apt upgrade<\/code><\/pre>\n
This will fetch and install any available updates, making sure your server is ready for the installation. Keeping your system updated is important whether you’re running on a local server or a UK Windows VPS<\/a>.<\/p>\n<\/section>\n
\n
Step 2: Install Java<\/h2>\n
XWiki requires Java to run. Install the latest version of OpenJDK by running the following command:<\/p>\n
sudo apt install openjdk-11-jdk<\/code><\/pre>\n
After installation, verify the Java installation with:<\/p>\n
java -version<\/code><\/pre>\n
The output should display the installed version of Java. This is a critical step to ensure XWiki runs correctly, regardless of whether you’re using Ubuntu or a Windows VPS hosting UK<\/a> environment.<\/p>\n<\/section>\n
\n
Step 3: Install and Configure a Database<\/h2>\n
XWiki uses a relational database to store its data. In this example, we will use MySQL. Install MySQL with the following command:<\/p>\n
sudo apt install mysql-server<\/code><\/pre>\n
Once the installation is complete, secure your MySQL installation by running:<\/p>\n
sudo mysql_secure_installation<\/code><\/pre>\n
Follow the on-screen prompts to set up a root password and remove unnecessary users. Then, log in to MySQL and create the XWiki database:<\/p>\n
\r\nsudo mysql -u root -p\r\nCREATE DATABASE xwiki;\r\nCREATE USER 'xwikiuser'@'localhost' IDENTIFIED BY 'yourpassword';\r\nGRANT ALL PRIVILEGES ON xwiki.* TO 'xwikiuser'@'localhost';\r\nFLUSH PRIVILEGES;\r\nEXIT;\r\n            <\/code><\/pre>\n
This database setup will allow XWiki to function properly on your server, whether it’s hosted locally or on a Windows VPSVirtual Private Server hosting<\/a> platform.<\/p>\n<\/section>\n
\n
Step 4: Install XWiki<\/h2>\n
To install XWiki, add the XWiki repository to your system:<\/p>\n
\r\nsudo apt install wget\r\nwget https:\/\/maven.xwiki.org\/stable\/xwiki-tomcat9-mysql\r\nsudo apt install .\/xwiki-tomcat9-mysql*.deb\r\n            <\/code><\/pre>\n
This command downloads and installs XWiki with Tomcat 9 as the application server and MySQL as the database.<\/p>\n<\/section>\n
\n
Step 5: Configure XWiki<\/h2>\n
After the installation, configure XWiki to connect to the MySQL database. Edit the XWiki configuration file:<\/p>\n
sudo nano \/etc\/xwiki\/xwiki.cfg<\/code><\/pre>\n
Look for the following lines and ensure they are configured as follows:<\/p>\n
\r\nxwiki.db=mysql\r\nxwiki.db.user=xwikiuser\r\nxwiki.db.password=yourpassword\r\n            <\/code><\/pre>\n
Save the file and restart Tomcat to apply the changes:<\/p>\n
sudo systemctl restart tomcat9<\/code><\/pre>\n<\/section>\n
\n
Step 6: Access XWiki<\/h2>\n
Once the installation and configuration are complete, you can access XWiki by opening a browser and navigating to http:\/\/your-server-ip:8080<\/code>. Follow the on-screen instructions to complete the initial setup.<\/p>\n
This method applies whether you’re running XWiki on a local server or using a UK VPS Windows<\/a> hosting solution.<\/p>\n<\/section>\n
\n
Step 7: Configure a Reverse Proxy (Optional)<\/h2>\n
If you’d like to access XWiki through a standard HTTP port (port 80), you can configure Nginx as a reverse proxy. Install Nginx with:<\/p>\n
sudo apt install nginx<\/code><\/pre>\n
Then, create a new Nginx configuration file:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/xwiki<\/code><\/pre>\n
Add the following content to the file:<\/p>\n
\r\nserver {\r\n    listen 80;\r\n    server_name your-domain.com;\r\n\r\n    location \/ {\r\n        proxy_pass http:\/\/localhost:8080;\r\n        proxy_set_header Host $host;\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    }\r\n}\r\n            <\/code><\/pre>\n
Enable the configuration and restart Nginx:<\/p>\n
\r\nsudo ln -s \/etc\/nginx\/sites-available\/xwiki \/etc\/nginx\/sites-enabled\/\r\nsudo systemctl restart nginx\r\n            <\/code><\/pre>\n
Now, you can access XWiki via http:\/\/your-domain.com<\/code>. This configuration is suitable for production environments, especially when using services like Windows VPS hosting UK<\/a>.<\/p>\n<\/section>\n