Differences

This shows you the differences between two versions of the page.

--- installs:wiki:setup [2024/01/27 14:09] – created elraphik
+++ installs:wiki:setup [2024/01/30 11:51] (current) – [5. Install PHP dependencies] elraphik
@@ Line 1: / Line 1: @@
-====== Initial setup for Dokuwiki ======
+====== Initial setup for DokuWiki ======
+To install this instance of DokuWiki, we had already some important components set up, but let's recap them quickly.
+===== Server =====
+First, we needed the server, which does not need too much hardware resources. You can use an old laptop or desktop as host, or have it run alongside other services on a server. We chose this last option here.
+OS-wise, the server runs on Debian 11 (bullseye), which should be perfectly fine.
+===== PHP Install=====
+To function properly, DokuWiki needs a web server that can run php, and obviously php, as we can see on their [[doku>reuirements|requirements page]].
+There are plenty of webservers to choose from, but here we already used [[https://www.nginx.com|nginx]] so we'll continue working with that one.
+As for php, we just need to install it. The version recommended by DokuWiki is php8, but the available major version on Debian 11's official repos is 7, so we'll need to add an external repo that contains php8.
+==== 1. Add Sury PHP repo ====
+As said above, the PHP 8.X packages are not available on the default base repositories, therefore we have to add the SURY repo manually.
+<code bash>
+echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main"\
+ | sudo tee /etc/apt/sources.list.d/sury-php.list
+</code>
+<WRAP center round info 100%>
+This is a single line command, so you can just copy/paste the whole command into your terminal and hit **Enter**.
+</WRAP>
+==== 2. Import GPG Key on Debian ====
+Now the system needs to verify the packages received from the SURY repo to confirm their authenticity.
+<code bash>
+wget -qO - "https://packages.sury.org/php/apt.gpg" | sudo apt-key add -
+</code>
+==== 3. Update APT cache ====
+Now we have to flush and rebuild the repositories cache so that APT is aware of the latest packages.
+<code bash>
+sudo apt update
+</code>
+==== 4. Install PHP 8.X ====
+Now that the repo is fully configured, we can just run the install command for php8 with apt package manager.
+<code bash>
+sudo apt install php8
+</code>
+==== 5. Install PHP dependencies ====
+Normally, we could've stopped there for our PHP 8 install, but DokuWiki needs a special PHP 8 package that may not be present by default after this install: ''php8.x-xml''. Also, as we'll use nginx as our web server, we have to install the package ''php8.x-fpm''.
+<code bash>
+sudo apt install php8.3-{xml,fpm}
+</code>
+<WRAP center round important 100%>
+Mind replacing ''8.3'' with the version of PHP installed on your machine for better compatibility.
+</WRAP>
+And that's it for the PHP install, we can now install DokuWiki itself, and then we'll do the Nginx configuration as it'll be easier afterwards.