DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== PHP build-in webserver ======

When installing DokuWiki as a desktop wiki on a personal computer, only PHP is needed. You can use the build-in PHP webserver. It avoids the hassle of installing and configuring a web server. See [[http://php.net/manual/en/features.commandline.webserver.php|PHP built-in webserver]] for more information.

Installing PHP on windows is really easy thanks to [[https://windows.php.net/download|https://windows.php.net]]. Macos used to ship with PHP, but since macos 12 Monterey, you have to install PHP yourself ; however, this is an easy task thanks to [[https://brew.sh/|homebrew]]. On Gnu/Linux systems the package manager generally provides a recent enough version of PHP.

Once PHP is installed, [[http://download.dokuwiki.org/|download DokuWiki]] and extract the files in a directory of your choosing. In this directory (containing the doku.php and index.php file) open a terminal and type in the following:

php -S localhost:8000 index.php

This will start the PHP webserver. For the first time, go to http://localhost:8000/install.php and fill in the form. Next time, just go directly to the wiki at http://localhost:8000/. The terminal window will need to stay open while you are running the server. If you do not want that, there are easy ways around, depending on your OS. Read further.

===== Further settings =====

The index.php script even handles URL rewriting. So you can set [[config:userewrite|userewrite]] option to 1. This is optional but will give you nice URLs. Go to the admin page, then "Configuration settings", and in the "Advanced" group you'll find the "Use nice URLs" setting, set it to ".htaccess".

===== Running DW without the terminal =====

On macos and Linux, you can close the terminal if you use this command :

nohup php -S localhost:8502 index.php &> /dev/null &

If you want to stop the PHP webserver, open a terminal and run
  pkill php

--------------

On a mac you can use Automator to create an APP file. Choose to create an application and choose to run a terminal command. Use the command mentioned above. When you save Automator asks you where to store the .app file. You can save it in your Applications folder.

Add ''&>/dev/null &'' to the terminal command if you do not want a spinning gear icon in the iconbar at the top of your screen.

When you start it the server will be started without a terminal window. To close the webserver you need to kill the php process in the ActivityMonitor.

===== Experiences =====

I am running a vanilla DokuWiki without any additional plugins with this install method for a couple of days now without any trouble. As mentioned on the PHP build-in webserver page this install is not usable for any production environment. But seems to me it is ok for a local desktop wiki. -- [[user>jroeterd]]

Please fill all the letters into the box to prove you're human. N᠎ I Z J S Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International