FAQ How to

show

Changed

Visitor's book Site map pmwiki-2.2.109

• login

Wiki setup

How to set up a wiki for an intranet on your home network. After you have done this you can use your wiki in your Website setup.

preparation

• read the PmWiki installation and initial setup tasks
• download the Apache httpd server (http://httpd.apache.org/) msi install
  • install the server, accept the defaults
  • at this point you can check the install by browsing to http://localhost/ or http://127.0.0.1/
  • if Apache fails to run it may be because another application, eg skype, is listening on port 80, in this case
    • change the directive Listen in the Apache http.conf to read Listen 127.0.0.1:80 12.34.56.78:80 (where 12.34.56.78:80 is your server's IP address)
• download PHP 5 (http://php.net/downloads.php) msi install
  • install PHP, accept the defaults
  • in php.ini make the following optional changes
    • enable the glib extension (set extension=php_gd2.dll)
    • double the default max memory size
    • consider increasing the max cpu time from 30 to 45 seconds

install PmWiki

• create the directory x:\home\wiki\
• download PmWiki (http://pmwiki.org/wiki/PmWiki/Download) (this wiki is version pmwiki-2.2.109, the current beta version is recommended)
  • open the PmWiki zip file and copy the contents of the \pmwiki\ directory into the \wiki\ directory
  • create directory x:\home\wiki\pmwiki\pub\skins\wiki and add pmwiki.tmpl and pmwiki.css to it
  • add file config.php to folder \pmwiki\local\
• optionally add 127.0.0.1 wiki to the hosts file in folder \WINDOWS\system32\drivers\etc\

set up web server

• check the following lines are in the apache \conf\config.http file (they should be there from the PHP install)

AddType application/x-httpd-php .php
PHPIniDir "x:Program FilesPHP\"
LoadModule php5_module "x:Program FilesPHPphp5apache2_2.dll"

• put the following lines into the apache \conf\extra\httpd-vhosts.conf file

NameVirtualHost 127.0.0.1:80
NameVirtualHost 12.34.56.78:80
<VirtualHost 127.0.0.1:80 12.34.56.78:80>
    ServerName wiki
    <Directory "x:/home/wiki/public_html">
      AllowOverride FileInfo AuthConfig Limit Options
      Options Includes FollowSymLinks
      Allow from all
    </Directory>
    DocumentRoot "x:/home/wiki/public_html"
</VirtualHost>

• in the /public_html/ directory create the file index.html with the contents <!--#include virtual="/pmwiki/pmwiki.php" -->
• check the following lines are uncommented in the apache \conf\config.http file

  AddType text/html .html
  AddOutputFilter INCLUDES .html
  

test

• restart the apache server
• open browser and enter http://wiki/

See also

Pm Wiki usage

fixed IP addresses

By default, chances are that your home network is configured using DHCP so that IP addresses are allocated automatically, and your modem or router will supply your PC's IP address. Once you have more than one computer in your home network, or if you wish to use your wiki as an external website, a fixed IP address is recommended for the computer running the web server. There are advantages in doing this

• one day your IP address will change, because the router is powered off long enough to loose its configuration, or it simply assigns a changed IP address, and you will wonder where your web site went.
• your can specify a hostname for a machine on your network and associate it with your fixed IP address in the hosts file

To set a fixed IP address on a Windows system try

• Control Panel | Network Connections | Local Area Connection
  • choose properties then on the General Tab scroll down to Internet Protocol (TCP/IP) and choose properties
  • set to addresses as specified by your ISP, choosing any fixed IP address outside te range allocated by your router