Fast installation

Download the single file installer install.php.zip

Uncompress the file, install it on the webroot of your server and run it.

Demo video: Install SofaWiki in one minute: install.mp4

Manual installation

Procedure to install SofaWki on your server.

• Download and extract the source files to your server
• Enable world write access (755) to the folder site and its subfolders
• Open the index.php with the browser. Enter the basic parameters
• swMainName is the name of your wiki and the name of the main page of the wiki
• swBaseHrefFolder is the URL path to the root folder of the wiki (including trailing slash /). Take attention to the protocol http or https.
• poweruser name is the name of the system user, to be defined hard coded in configuration
• poweruser pass is the password of the system user
• default lang is the language of the wiki. If you have multiple languages, set them later manually
• default skin is the skin of the wiki,. You can choose half a dozen of predefined designs. You can change them later manually.
• Login and create your main page.

Install locally

You can also install the wiki locally on your mac. For that you need to

• Download the SofaWiki to a local folder
• Open Terminal
• cd to the local folder
• php -S localhost:9000
• Open URL localhost:9000 in browser
• Finish installation
• Fix write access to site folder
• Use / for swBaseHrefFolder

Note: The notify by mail will not work locally, if you do not have a SMTP server configured to work with PHP

Going further

Your wiki is now running. You can go further manually editing the files on the site

• Edit the site/configuration.php file. See Configuration.
• Create your own skin as a copy of default.php and enable it in configuration.php
• You may need to add an htaccess file.
• If you are using Cpanel, you must turn off MODSECURITY for the domain.

You can update from the Special:Update page. You may want to make a snapshot before you update.
The update has 3 steps the wiki does for you:

1. Download the zip file from the remote server to your server into the SofaWiki root.
2. Decompress the zip file into a folder install in the SofaWiki root. Check that all files are there.
3. Install: Replace the inc folder and the index.php and the api.php file by the versions in the install folder and delete the install folder