DocPHT is a free open-source software designed to create and manage small to medium-sized documentation websites. In this tutorial, we will go through a complete and simple installation of DocPHT on Debian.
Before you start installing DocPHT on Debian, you should ensure you have the following prerequisites:
To start, connect to your Debian system via SSH and update the system package manager's cache:
sudo apt update
After updating the package manager's cache, upgrade the existing packages:
sudo apt upgrade
DocPHT is a PHP application, and we need to install some PHP modules on our Debian system. Install the following packages to meet all the dependencies:
sudo apt install php7.x-xml php7.x-mbstring php7.x-zip
Once the packages are installed, restart the Apache webserver with the following command:
sudo systemctl restart apache2
Now we will download and install the DocPHT files. Download the latest version of DocPHT from the official website. To download it to the current directory, use the following command:
wget https://github.com/ronanguilloux/DocPHT/archive/refs/tags/v2.2.3.tar.gz
After downloading the package, extract it using the following command:
tar -xzf v2.2.3.tar.gz
Move the extracted files to the Apache webserver document root directory. By default, the document root directory for Apache is /var/www/html/. The following command will move the files to the Apache web server document root directory:
sudo mv DocPHT-2.2.3/* /var/www/html/
After moving the DocPHT files to the document root directory, we need to set the right permissions for our Apache user. Run the following command to change the ownership of the Apache web server document root directory:
sudo chown -R www-data:www-data /var/www/html/
Now set the permissions using the following command:
sudo chmod -R 755 /var/www/html/
To access DocPHT from the web, we need to set up a virtual host for the application. In this example, we will use the default Apache virtual host configuration file /etc/apache2/sites-available/000-default.conf.
Open the 000-default.conf file using the following command:
sudo nano /etc/apache2/sites-available/000-default.conf
Add the following lines to the file:
<VirtualHost *:80>
ServerName your_server_domain_or_IP
DocumentRoot /var/www/html
<Directory "/var/www/html">
AllowOverride All
</Directory>
</VirtualHost>
Replace "your_server_domain_or_IP" with your server's hostname or IP address. Save the changes and exit the text editor.
After the changes made, enable the virtual host by running the following command:
sudo a2ensite 000-default.conf
Restart Apache for the new configuration to take effect:
sudo systemctl restart apache2
After completing all the preceding steps, open your preferred web browser and access http://server_hostname_or_IP/ to access DocPHT.
Congratulations! You have installed DocPHT on your Debian system.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
