- \n
- A server running Debian 12 with a minimum of 2GB of RAM and 2 CPU cores. Our Linux Cloud VPS<\/a> LC VPS-2 plan is great for this.<\/li>\n\n\n\n
- A domain name to access the wiki from the internet (optional).<\/li>\n\n\n\n
- SSH access with sudo privileges, or root access.<\/li>\n<\/ul>\n\n\n\n
Step 1. Log in to your server<\/h2>\n\n\n\n
First of all, we need to log in to our Debian 12 VPS through SSH:<\/p>\n\n\n\n
ssh root@IP_Address -p Port_number<\/pre>\n\n\n\n
Replace “root” with a user that has sudo privileges. Additionally, replace \u201cIP_Address\u201d and \u201cPort_Number\u201d with your server\u2019s respective IP address and SSH port number. Next, let\u2019s make sure that we\u2019re on Debian 12. You can do that like this:<\/p>\n\n\n\n
# lsb_release -a<\/pre>\n\n\n\n
You should get this as the output:<\/p>\n\n\n\n
No LSB modules are available.
Distributor ID: Debian
Description: Debian GNU\/Linux 12 (bookworm)
Release: 12
Codename: bookworm<\/pre>\n\n\n\nThen, run the following command to make sure that all installed packages on the server are updated to their latest available versions:<\/p>\n\n\n\n
# apt update && apt upgrade<\/pre>\n\n\n\n
Step 2. Install OpenJDK<\/h2>\n\n\n\n
In order to proceed with XWiki installation on Debian 12, it is necessary to install Java first. As a prerequisite, execute the command below to ensure Java is installed on your system.<\/p>\n\n\n\n
# apt install default-jdk -y<\/pre>\n\n\n\n
Java has been installed now, we can verify the version by running this command:<\/p>\n\n\n\n
# java --version<\/pre>\n\n\n\n
The command will print an output similar to this:<\/p>\n\n\n\n
openjdk 17.0.9 2023-10-17
OpenJDK Runtime Environment (build 17.0.9+9-Debian-1deb12u1)
OpenJDK 64-Bit Server VM (build 17.0.9+9-Debian-1deb12u1, mixed mode, sharing)<\/pre>\n\n\n\nStep 3. Install XWiki<\/h2>\n\n\n\n
There are several ways to install XWiki, but in this article, we are going to install it the easiest way. Let’s start by adding the repository.<\/p>\n\n\n\n
# wget https:\/\/maven.xwiki.org\/xwiki-keyring.gpg -O \/usr\/share\/keyrings\/xwiki-keyring.gpg\n# wget \"https:\/\/maven.xwiki.org\/stable\/xwiki-stable.list\" -O \/etc\/apt\/sources.list.d\/xwiki-stable.list<\/pre>\n\n\n\n
The GPG key has been successfully imported and packages from this repository will be considered trusted. But, before installing the packages from the newly added repository you must update the package index, and invoke this command:<\/p>\n\n\n\n
# apt update<\/pre>\n\n\n\n
Then, let’s proceed with the installation.<\/p>\n\n\n\n
# apt install xwiki-xjetty-mariadb<\/pre>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-dbconfig-common-970x156.jpg\")
<\/a><\/figure>\n\n\n\nChoose Yes, then hit ENTER:<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-dbpassword.jpg\")
<\/a><\/figure>\n\n\n\nJust hit ENTER to continue, and the installer will create a random database password for your XWiki installation.<\/p>\n\n\n\n
Once completed, you can navigate to
http:\/\/YOUR_SERVER_IP_ADDRESS:8080<\/code> to complete XWiki installation.<\/p>\n\n\n\n![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-distro-wizard.jpg\")
<\/a><\/figure>\n\n\n\nClick on the Continue button to proceed to the next steps.<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/12\/xwiki-debian-12-create-admin.jpg\")
<\/a><\/figure>\n\n\n\nFill out the forms and then click the ‘Register and login’ button then you will be brought to this page:<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/12\/xwiki-debian-12-admin-user.jpg\")
<\/a><\/figure>\n\n\n\nClick Continue to proceed.<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-flavor.jpg\")
<\/a><\/figure>\n\n\n\nIn this step, you are asked whether to install a flavor or not. Click on the available flavor then hit ‘Install this flavor’ button to install it.<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-flavor-start.jpg\")
<\/a><\/figure>\n\n\n\nClick install to install the flavor. You will need to wait for a few minutes until it finishes and click the Continue button.<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-report.jpg\")
<\/a><\/figure>\n\n\n\nClick Continue:<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.linuxcloudvps.com\/blog\/wp-content\/uploads\/2023\/11\/xwiki-dashboard-970x534.jpg\")
<\/a><\/figure>\n\n\n\nThat’s it, you are brought to the XWiki main page now.<\/p>\n\n\n\n
Step 4. Install and Configure Nginx<\/h2>\n\n\n\n
At this point, XWiki has been installed and we can access it at
http:\/\/SERVER_IP:8080<\/code>. To access it through a domain or subdomain, we need to create a reverse proxy. In this step, we are going to install and configure nginx as the reverse proxy.<\/p>\n\n\n\nSimply execute this command below to install Nginx<\/p>\n\n\n\n
# apt install nginx<\/pre>\n\n\n\n
Once installed, Nginx will automatically run and we can create an Nginx server block to host our XWiki website.<\/p>\n\n\n\n
# nano \/etc\/nginx\/conf.d\/xwiki.conf<\/pre>\n\n\n\n
Insert the following content into the file<\/p>\n\n\n\n
map $request_uri $expires {\ndefault off;\n~*\\.(ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|js|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|wav|bmp|rtf)(\\?|$) 1h;\n~*\\.(css) 0m;\n}\n\nexpires $expires;\n\nserver {\n listen 80;\n server_name xwiki.yourdomain.com;\n charset utf-8;\n\n root \/var\/www\/html;\n\n location \/.well-known {\n alias \/var\/www\/html;\n }\n\n location \/ {\n rewrite ^ $scheme:\/\/$server_name\/xwiki$request_uri? permanent;\n }\n\n location ^~ \/xwiki {\n proxy_pass http:\/\/localhost:8080;\n proxy_cache off;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header Host $http_host;\n proxy_set_header X-Forwarded-Proto $scheme;\n expires $expires;\n }\n}<\/pre>\n\n\n\nMake sure to replace
xwiki.yourdomain.com<\/code> with your actual domain or subdomain name pointing to your server IP address. Then, save the file and exit from the editor then reload nginx.<\/p>\n\n\n\n# systemctl reload nginx<\/pre>\n\n\n\n
Now, you should be able to access XWiki at
http:\/\/xwiki.yourdomain.com<\/code><\/p>\n\n\n\nStep 5. Install Free SSL Certificate<\/h2>\n\n\n\n
This is an optional step, but you should consider installing an SSL certificate for your XWiki website. Let’s execute the command below to install
certbot<\/code>:<\/p>\n\n\n\n# apt install certbot python3-certbot-nginx -y<\/pre>\n\n\n\n
Once installed, simply run this command and follow what you see on the screen:<\/p>\n\n\n\n
# certbot<\/pre>\n\n\n\n
The prompts should look like this:<\/p>\n\n\n\n
Saving debug log to \/var\/log\/letsencrypt\/letsencrypt.log\nEnter email address (used for urgent renewal and security notices)\n (Enter 'c' to cancel): you@yourdomain.com\n\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\nPlease read the Terms of Service at\nhttps:\/\/letsencrypt.org\/documents\/LE-SA-v1.3-September-21-2022.pdf. You must\nagree in order to register with the ACME server. Do you agree?\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n(Y)es\/(N)o: Y\n\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\nWould you be willing, once your first certificate is successfully issued, to\nshare your email address with the Electronic Frontier Foundation, a founding\npartner of the Let's Encrypt project and the non-profit organization that\ndevelops Certbot? We'd like to send you email about our work encrypting the web,\nEFF news, campaigns, and ways to support digital freedom.\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n(Y)es\/(N)o: N\nAccount registered.\n\nWhich names would you like to activate HTTPS for?\nWe recommend selecting either all domains, or all domains in a VirtualHost\/server block.\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n1: xwiki.yourdomain.com\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\nSelect the appropriate numbers separated by commas and\/or spaces, or leave input\nblank to select all options shown (Enter 'c' to cancel): 1\nRequesting a certificate for xwiki.yourdomain.com\n\nSuccessfully received certificate.\nCertificate is saved at: \/etc\/letsencrypt\/live\/xwiki.yourdomain.com\/fullchain.pem\nKey is saved at: \/etc\/letsencrypt\/live\/xwiki.yourdomain.com\/privkey.pem\nThis certificate expires on 2024-02-17.\nThese files will be updated when the certificate renews.\nCertbot has set up a scheduled task to automatically renew this certificate in the background.\n\nDeploying certificate\nSuccessfully deployed certificate for xwiki.yourdomain.com to \/etc\/nginx\/conf.d\/xwiki.conf\nCongratulations! You have successfully enabled HTTPS on https:\/\/xwiki.yourdomain.com\n\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\nIf you like Certbot, please consider supporting our work by:\n * Donating to ISRG \/ Let's Encrypt: https:\/\/letsencrypt.org\/donate\n * Donating to EFF: https:\/\/eff.org\/donate-le\n- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -<\/pre>\n\n\n\n
\n\n\n\nOnce the SSL certificate installation is finished, the installer will modify your Nginx server block in
\/etc\/nginx\/conf.d\/xwiki.conf<\/code> and reload Nginx to apply the file changes.<\/p>\n\n\n\nThat’s it all! You have followed this article, and you managed to install XWiki on your Debian 12 Cloud VPS<\/a>. Your XWiki installation should be accessible at
https:\/\/xwiki.yourdomain.com<\/code>.<\/p>\n\n\n\nIf you liked this post on how to install Xwiki on Debian 12, please share it with your friends on social networks using the buttons below or simply leave a reply in the comments section. Thanks.<\/p>\n","protected":false},"excerpt":{"rendered":"