Wikka Documentation : WikkaOnMacOSX

HomePage :: Index :: RecentChanges :: Search :: Login/Register

Installing Wikka Wiki on Mac OS X


See also:
Apple logo
 


Installing WikkaWiki to run on your Mac takes only a few minutes. All the installation is done through a web-based wizard and you should not need to open the terminal a single time. Once the installation is complete, you will have a full Wikka system running on your machine and ready to play with.

Table of contents
  1. System Requirements
  2. Get the package
  3. Run the installation wizard
  4. Start playing
  5. Forthcoming



1. System Requirements


This tutorial assumes your machine is configured to allow installing PHP/MySQL applications:


Note that in order to install WikkaWiki, you will be required to fill in your DB parameters (server, DB name, DB user, password).



2. Get the package


Download the latest package from the Wikka website.


Wikka Installation Screenshot


Double-click on the downloaded package to unzip it


Wikka Installation Screenshot


Copy the Wikka folder to a directory accessible from your localhost, for instance in the Sites folder of your user account:


Wikka Installation Screenshot



3. Run the installation wizard


First, open the Sharing panel from your System Preferences and make sure that Personal Web Sharing is on (this enables your apache server to serve content from your local Sites folder):


Wikka Installation Screenshot


Open your browser and point it to the localhost folder where you have copied the Wikka files, in our example: http://localhost/~username/Wikka: the Wikka Installation Wizard will appear.

As a first step, you will need to enter your DB settings. You can choose a table prefix for your Wikka installation, in our example: mywiki_


Wikka Installation Screenshot


Unless you want to modify the default settings for the syntax highlighter you can skip the GeSHi Configuration section and go directly to the Wikka Site Configuration section and add the name of your site and the starting page.


Wikka Installation Screenshot


Add the required information in the Administrative account configuration. You can skip the Wikka URL configuration section (more information) and click on "Continue".


Wikka Installation Screenshot


The wizard will try to connect to your database and create the Wikka tables: if you correctly filled in all the required DB parameters you should see the following screen. Click on "Continue" to continue the installation.


Wikka Installation Screenshot


As a last step, the wizard will try to write the system configuration to a file called wikka.config.php (more information). If your Wikka folder is write-accessible to your server, you should see the following screen.


Wikka Installation Screenshot

If you get a write error alert, this means that the wizard is not able to save the configuration file. Two solutions are possible:
  1. make the Wikka folder write-accessible following the instructions given on the screen and retry
  2. simply copy the code in the gray block, paste it in a text editor and save it as wikka.config.php in the Wikka folder.


Wikka Installation Screenshot



4. Start playing


If you arrived at this point, your WikkaWiki should be up and running. The default homepage will look like the following:


Wikka Installation Screenshot


To start editing it, just double-click anywhere on the page: the edit screen will open to let you modify the content of the page.


Wikka Installation Screenshot


Click on "Store" to save your modifications and you will be redirected to the modified page.


Wikka Installation Screenshot



That's all folks...

...enjoy your Wikka!


CategoryEN
There are no comments on this page.
Creative Common Attribution-ShareAlike License
Valid XHTML 1.0 Transitional :: Valid CSS :: Powered by WikkaWiki
Page was generated in 0.0293 seconds