From Clothbot

Jump to: navigation, search


How To Install a Local MediaWiki

Specific to Mac OS X

  • Performed on a Leopard-upgraded-from-Tiger machine (not clean)


  1. Download mysql-5.0.45-osx10.4-i686.dmg [1]
    1. Read the included ReadMe.txt file
    2. Shut down any existing MySQL servers that are running
    3. Launch the pkg installer (mysql-5.0.45-osx10.4-i686.pkg)
    4. Install the MySQLStartupItem.pkg to make automatic start-up easier to manage.
  2. In your System Preferences, go into Sharing and turn on Web Sharing
    1. Terminal: sudo vi /etc/apache2/httpd.conf
      • Uncomment: LoadModule php5_module libexec/apache2/
        • vi (find the php5 string): /php5
        • vi (move to the start of the line): ^
        • vi (erase the # character): x
        • vi (colon character, write and quit): :wq
    2. GUI Editor Alternative: sudo /Applications/ /etc/apache2/httpd.conf
      • Erase the # in front of the LoadModule php5_module libexec/apache2/ line.
      • Save and exit. Make sure it does not Line-Wrap.
  3. Reboot so mysql and apache start up fresh.
  4. Download MediaWiki [2]
    1. Read the Installation Guide [3]
    2. Terminal: cd /Library/WebServer/Documents
    3. Terminal: sudo mkdir wiki
    4. Terminal: cd wiki
    5. Terminal: sudo tar xvfz ~/Downloads/mediawiki-1.11.0.tar.gz
    6. Browse to http://localhost/wiki/mediawiki-1.11.0/
      • Note the message to change permissions:
        • Terminal: cd .../mediawiki-1.11.0
        • Terminal: sudo chmod a+w config
        • Retry running configuration.
    7. Configure using the web form
      • If you're going to use a Creative Commons license, configure it first before anything else. The new form won't retain of the field values so you'll be entering things twice.
      • Be sure to assign a prefix in the Database table prefix field. Makes it easier to maintain multiple wikis and/or start from scratch.
      • Error: Attempting to connect to database server as root...failed with error [2002] Can't connect to local MySQL server through socket /var/lib/mysql/mysql.sock
        • Change: Field Database Host from localhost to
      • Error: Attempting to connect to database server as wikiuser...failed due to authentication errors. Check passwords.
        • Change:
          • Checkbox Superuser account to checked
          • Leave field Superuser password blank.
    8. Terminal: sudo mv config/LocalSettings.php .
  5. Follow the link to http://localhost/wiki/mediawiki-1.11.0/index.php

Tips and Tricks

  1. Download and install CocoaMySQL [4] to more easily maintain your MySQL databases.
  2. If you want to reconfigure your wiki from scratch, delete or rename the LocalSettings.php and rerun the install process.


Personal tools