![\"Dokuwiki](\"https:\/\/www.techcoil.com\/blog\/wp-content\/uploads\/dokuwiki-and-raspbian-icon.gif\"){kind=icon}
<\/p>\n<\/p>\n
As a result of the proliferation of single-board computers<\/a> like the Raspberry Pi 3<\/a>, we get energy-efficient computers. In addition to being energy-efficient, Raspberry Pi 3 is small and priced affordably. Therefore, the Raspberry Pi 3 is an ideal gift for programmers<\/a>. <\/p>\n Given that you had received one as a programmer, you may be wondering what you can do with it<\/a>. In case you are yearning for your own Wiki site, you may consider setting up your DokuWiki<\/a> site on your Raspberry Pi 3. <\/p>\n With this in mind, this post walks through how you can setup your own Wiki site on a Raspberry Pi 3 with Raspbian Stretch Lite<\/a>, Nginx<\/a> and PHP<\/a>.<\/p>\n In case you are wondering what to buy for your Raspberry Pi 3 project<\/a>, you can consider the following hardware list: <\/p>\n Once you had gathered all the necessary hardware, proceed to setup Raspbian Stretch Lite with SSH server enabled on your microSD card<\/a>. When you had done so, you will be able to SSH into your Raspbian Stretch Lite to perform further configurations. <\/p>\n Next, remove your microSD card from your SD card reader and insert it to the microSD card slot on the Raspberry Pi 3 board. Thereafter, proceed to assemble the Raspberry Pi 3 board to the Official Raspberry Pi case<\/a>.<\/p>\n Following the assembly of your Raspberry Pi 3 board and Official Raspberry Pi case, connect one end of the RJ45 cable to the RJ45 port on your Raspberry Pi 3 board and the other end of the cable to one of the switch port of your home router<\/a>. After that, connect your micro USB cable and supply power to your Raspberry Pi 3 board.<\/p>\n There are a few configurations that we should perform on the first run of our Raspbian Stretch Lite. Therefore, proceed on to change the default password, Locale and Timezone of Raspbian Stretch Lite<\/a>. <\/p>\n Once you had preformed the configurations on the first run of your Raspbian Stretch Lite, proceed on to install Nginx. To install Nginx on Raspbian Stretch Lite, run the following command:<\/p>\n After that, run the following command to verify that the installation was successful:<\/p>\n At this point, as an indication that Nginx was installed successfull, you should see output similar to the following:<\/p>\n Since Dokuwiki is written in PHP, proceed to install PHP7, PHP7 Fast CGI Process Manager and After that, verify your PHP installation with the following command:<\/p>\n At this instant, as an indication that PHP 7 was installed successfully, you should see output similar to the following:<\/p>\n Once you had verified that PHP 7 was installed successfully, you can proceed to download a copy of Dokuwiki. To do so, run the following commands:<\/p>\n After that, you will find a directory Since Dokuwiki keeps data within the source directory by default, you should change the ownership of At this point in time, you are ready to configure Nginx to proxy HTTP requests bound for a custom domain. For the purpose of this guide, let's arbitrarily define the custom domain as mydokuwikiathome<\/strong>. Whenever Nginx sees HTTP requests made to http:\/\/mydokuwikiathome<\/strong>, it should proxy those requests to PHP 7 Fast CGI Manager so as to bring up Dokuwiki.<\/p>\n With this in mind, first create a Nginx configuration file at Once After that, type Ctrl-X<\/strong> followed by Y<\/strong> to save the configuration file.<\/p>\n Once you had saved the configuration file, run the following command to restart Nginx:<\/p>\n Once you had restarted Nginx, go to your hosts file in your computer and add in a row like the following:<\/p>\n In this case, your browser will send HTTP requests to Following the changes to your hosts file, open up your favourite browser on your computer and enter Once you had filled in the necessary input fields, click the Save<\/strong> button. After that, you will be presented with the following screen:<\/p>\n This is an indication that you had gotten a DokuWiki site running on your Raspberry Pi 3.<\/p>\n Since DokuWiki had suggested you to delete At this point in time, you had setup a DokuWiki site on your Raspberry Pi 3 that can only be accessed from within your home network.<\/p>\n In case you want to access your DokuWiki site from outside your home network, there are more configurations to be done.<\/p>\n As mentioned in an earlier post on how to host multiple websites from home<\/a>, you will need the following pieces for enabling your DokuWiki site to be accessed from outside your home network via HTTPS with Let's Encrypt browser-trusted certificate:<\/p>\nRecommended hardware list for your own Raspberry Pi 3 Dokuwiki<\/h2>\n
\n
Setting up Raspbian Stretch Lite with SSH server enabled on your microSD card<\/h2>\n
Assembling the hardware for your Raspberry Pi 3 Wiki site<\/h2>\n
Starting the Raspbian Stretch Lite operating system<\/h2>\n
Changing default password, Locale and Timezone of your Raspbian Stretch Lite<\/h2>\n
Installing Nginx on Raspbian Stretch Lite<\/h2>\n
\r\nsudo apt-get update\r\nsudo apt-get install nginx -y\r\n<\/pre>\n
\r\nsystemctl status nginx.service\r\n<\/pre>\n
\r\n\u25cf nginx.service - A high performance web server and a reverse proxy server\r\n Loaded: loaded (\/lib\/systemd\/system\/nginx.service; enabled; vendor preset: enabled)\r\n Active: active (running) since Wed 2018-05-16 19:25:05 UTC; 7min ago\r\n Docs: man:nginx(8)\r\n Process: 15356 ExecStart=\/usr\/sbin\/nginx -g daemon on; master_process on; (code=exited, status=0\/SUCCESS)\r\n Process: 15353 ExecStartPre=\/usr\/sbin\/nginx -t -q -g daemon on; master_process on; (code=exited, status=0\/SUCCESS\r\n Main PID: 15357 (nginx)\r\n CGroup: \/system.slice\/nginx.service\r\n \u251c\u250015357 nginx: master process \/usr\/sbin\/nginx -g daemon on; master_process on;\r\n \u251c\u250015358 nginx: worker process\r\n \u251c\u250015359 nginx: worker process\r\n \u251c\u250015360 nginx: worker process\r\n \u2514\u250015361 nginx: worker process\r\n \r\nMay 16 19:25:05 raspberrypi systemd[1]: Starting A high performance web server and a reverse proxy server...\r\nMay 16 19:25:05 raspberrypi systemd[1]: Started A high performance web server and a reverse proxy server.\r\n<\/pre>\n
Installing PHP 7 on your Raspbian Stretch Lite<\/h2>\n
php7.0-mbstring<\/code>:<\/p>\n\r\nsudo apt-get install php7.0 php7.0-fpm php7.0-mbstring -y\r\n<\/pre>\n
\r\nsystemctl status php7.0-fpm.service\r\n<\/pre>\n
\r\n\u25cf php7.0-fpm.service - The PHP 7.0 FastCGI Process Manager\r\n Loaded: loaded (\/lib\/systemd\/system\/php7.0-fpm.service; enabled; vendor preset: enabled)\r\n Active: active (running) since Wed 2018-05-16 19:25:05 +8; 7min ago\r\n Docs: man:php-fpm7.0(8)\r\n Main PID: 7995 (php-fpm7.0)\r\n Status: "Processes active: 0, idle: 2, Requests: 0, slow: 0, Traffic: 0req\/sec"\r\n CGroup: \/system.slice\/php7.0-fpm.service\r\n \u251c\u25007995 php-fpm: master process (\/etc\/php\/7.0\/fpm\/php-fpm.conf)\r\n \u251c\u25007996 php-fpm: pool www\r\n \u2514\u25007997 php-fpm: pool www\r\n \r\nMay 16 19:25:05 raspberrypi systemd[1]: Starting The PHP 7.0 FastCGI Process Manager...\r\nMay 16 19:25:06 raspberrypi systemd[1]: Started The PHP 7.0 FastCGI Process Manager.\r\n<\/pre>\n
Downloading a copy of Dokuwiki<\/h2>\n
\r\ncd \/var\/www\r\nsudo wget https:\/\/download.dokuwiki.org\/src\/dokuwiki\/dokuwiki-stable.tgz\r\nsudo tar xfz dokuwiki-stable.tgz\r\nsudo rm dokuwiki-stable.tgz\r\n<\/pre>\n
\/var\/www\/dokuwiki-xxx<\/code> where xxx can vary depending on the version of the stable release. For the purpose of this guide, let us assume that we had gotten the directory \/var\/www\/dokuwiki-2018-04-22a<\/code>. This is the directory that contains the source code for realising your Wiki site.<\/p>\nChanging the owner of \/var\/www\/dokuwiki-2018-04-22a directory to www-data user<\/h2>\n
\/var\/www\/dokuwiki-2018-04-22a<\/code> directory to www-data<\/code> user. To do so, run the following command:<\/p>\n\r\nsudo chown -R www-data:www-data \/var\/www\/dokuwiki-2018-04-22a\r\n<\/pre>\n
Configuring Nginx to proxy HTTP requests bound for a custom domain to PHP 7 Fast CGI Manager<\/h2>\n
\/etc\/nginx\/sites-enabled\/mydokuwikiathome.conf<\/code> with the following command:<\/p>\n\r\nsudo nano \/etc\/nginx\/sites-enabled\/mydokuwikiathome.conf\r\n<\/pre>\n
nano<\/code> editor loads up, copy the following content to the editor:<\/p>\n\r\nserver {\r\n listen 80;\r\n server_name mydokuwikiathome;\r\n \r\n root \/var\/www\/dokuwiki-2018-04-22a;\r\n\r\n location \/ {\r\n index doku.php; \r\n try_files $uri $uri\/ @dokuwiki; \r\n }\r\n \r\n location @dokuwiki {\r\n rewrite ^\/_media\/(.*) \/lib\/exe\/fetch.php?media=$1 last;\r\n rewrite ^\/_detail\/(.*) \/lib\/exe\/detail.php?media=$1 last;\r\n rewrite ^\/_export\/([^\/]+)\/(.*) \/doku.php?do=export_$1&id=$2 last;\r\n rewrite ^\/(.*) \/doku.php?id=$1&$args last;\r\n }\r\n \r\n location ~ \\.php$ {\r\n include fastcgi_params;\r\n fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\r\n fastcgi_pass unix:\/run\/php\/php7.0-fpm.sock;\r\n } \r\n\r\n location ~ \/(data|conf|bin|inc)\/ {\r\n deny all;\r\n }\r\n\r\n}\r\n<\/pre>\n\r\nsudo systemctl restart nginx.service\r\n<\/pre>\n
Setting your hosts file to point mydokuwikiathome to the IP address of your Raspberry Pi 3<\/h2>\n
\r\n192.168.1.109 mydokuwikiathome\r\n<\/pre>\n
192.168.1.109<\/code> whenever it sees the domain name mydokuwikiathome<\/code>. In case your Raspberry Pi 3 gets a different IP address, make sure to substitute that IP address with 192.168.1.109<\/code>.<\/p>\nTriggering the install script for DokuWiki<\/h2>\n
http:\/\/mydokuwikiathome\/install.php<\/code> in the location bar. After that, you should see the following screen:<\/p>\n![\"DokuWiki](\"https:\/\/www.techcoil.com\/blog\/wp-content\/uploads\/DokuWiki-version-2018-04-22a-installer-screen.gif\")
<\/p>\n![\"DokuWiki](\"https:\/\/www.techcoil.com\/blog\/wp-content\/uploads\/DokuWiki-version-2018-04-22a-installer-screen-after-saving-initial-setup-info.gif\")
<\/p>\ninstall.php<\/code>, go back to the SSH terminal session and run the following command:<\/p>\n\r\nsudo rm \/var\/www\/dokuwiki-2018-04-22a\/install.php\r\n<\/pre>\n
Configuring your DokuWiki to be accessed from outside your home network via HTTPS with Let's Encrypt certificate<\/h2>\n
Pre-requisites<\/h3>\n
\n
Installing CertBot<\/h3>\n