Manual:Running MediaWiki on Mac OS X

From MediaWiki.org
Jump to: navigation, search

The primary development and deployment environment for MediaWiki is on Linux and Unix systems; Mac OS X is Unix under the hood, so it's fairly straightforward to run it.

Get requirements[edit | edit source]

Requirements Requirements in short
  • Download MediaWiki (current stable version is 1.24.1)
  • Web server such as Apache or IIS
    • Local or command line access is needed for running maintenance scripts

For image thumbnailing and TeX-support, additional programs are required.

(*) – MariaDB, a GPL fork of the MySQL code by Monty Widenius, the founder of MySQL, is an alternative and can also be used by MediaWiki. Debian/Ubuntu repos.


Instead of setting the required software up separately you might be better off to start with MAMPstack + MediaWiki, which gives you Apache, MySQL, PHP & MediaWiki in one convenient package.

MAMP[edit | edit source]

For a personal Wiki environment, you may find it easier to install MAMP, if you are using Mac OS X 10.4 or newer (MAMP will not run on Mac OS X 10.3 or older). This installer will provide its own Apache, MySQL and PHP (with eAccelerator (an updated MMCache) and Zend Optimizer) and a nice simple control panel, running under your login (in other words, this really isn't configured to work as a production server, so don't do that). If you turn off the Mac's built-in personal web server, you can run MAMP's Apache on port 80.

You will still need to install ImageMagick, but otherwise everything MediaWiki needs will be there. Note that with MAMP your personal Web directory defaults to /Applications/MAMP/htdocs instead of the Mac's usual /Users/yourname/Sites. If you don't want to store your own data files in the Applications directory, open MAMP's Preferences, select the Apache tab, and change the document root to the directory of your choice. /Users/yourname/Sites is an excellent choice. Clicking on MAMP's Open Start page button will open http://localhost:8888/MAMP/ in your browser to show you how things are configured.

Install MediaWiki[edit | edit source]

For experienced users, here is the quick version of the installation instructions. Most users will want to go through all the passages.

  1. Check that your system meets the minimum requirements
  2. Download MediaWiki (direct link to latest version) and extract the archive to a web-accessible folder on your server.
  3. Point your browser to the directory where MediaWiki was extracted and follow the link to the setup screen. It should be in the form http://[domain]/[directory]/mw-config/index.php. Replace [directory] with the path to your extracted MediaWiki folder. If installing on a local machine, replace [domain] with [localhost]. A locally installed wiki will need the LocalSettings.php modified from [localhost] to [domain] if you will ever be accessing the wiki from that domain. If installed on a remote server, replace [domain] with your server's domain name (eg: www.myserver.com).
  4. Follow the on-screen instructions to complete the process.

These instructions are deliberately brief. There is a lot that could go wrong, so if in doubt, you are advised to read the full instructions!


TeX support[edit | edit source]

See Manual talk:Running MediaWiki on Mac OS X#Mathematics for explicit instructions on how to add TeX support for MacOS X.

Language: English  • français • 日本語
Retrieved from "http://www.mediawiki.org/w/index.php?title=Manual:Running_MediaWiki_on_Mac_OS_X&oldid=1317911"