Skip to content

Configure the Wiki

Mark Richards edited this page Apr 22, 2022 · 1 revision

Following the setup link should take you to the interactive wiki setup pages.

Select a language

Environmental Checks

The wiki will check to make sure that it has the proper environment to run.

Database Connection

The wiki will attempt to connect to the database so you will need to provide the URL to the database. Previously we references this as DBHOST.
It will also ask what you would like the database to be called on the server. I used a default value of my_wiki.
It will also ask if you would like to use a Prefix on your tables. This would allow you to host multiple wikis in the same database but keep them separate by prefixing the table names.
Finally it will ask for a username (DBUSER) and password (DBPASS) that it can use to log in and build the tables.
It is possible to use a separate account for this creation step than for the day to day read and write access.

Database User/Pass

As mentioned in the previous step it is possible to use a separate account for this creation step than for the day to day read and write access.
Here you can select to use the same username and password or to use a separate username and password.
I selected to use the same for both as the daily read/write username and password will be provided to the system by the environmental variables we already created

Wiki Name and Administrator

Here you will enter a name for your wiki as well as create the wiki system administrator account.
Email addresses are optional. I did not want notifications so I left them blank
I did want to set more of the options so I selected that radio button before continuing but you can also allow the system to just finalize setup with default values.

Wiki Name and Administrator

Here you will be given some look and feel options that set things like the theme and enables common extensions.
I wanted this wiki to require a login for viewing as well as editing so I set the pages to Private.
I did not set a license
I did not set up outbound email servers
I prefer the look of the Monobook theme so I set that as my default
I also wanted most of the special pages, editors, parsers, media handlers, spam preventions, and other extensions
Note: The visual Editor will generate errors on the pages if enabled. There are forums discussing fixes to the visual editor code but I did not mind keeping it disabled. I also enabled the File upload optioon and did not alter the default locations
Finally I let PHP handle the caching

Confirm Settings

You will be asked if you are ready to install the database tables and generate the configuration file with the options you have selected.

Installation

Here the setup will go one by one though your settings indicating if it was successful and finally it will connect to the DB and build the required tables.

Save the Configuration File

All of the settings you just entered will be written to a file called LocalSettings.php This file needs to be uploaded to the configuration file share so that the container can read when it starts up. Save this file to somewhere you will be able to find it on your local machine. We will use it in the next steps.

Next Steps

Modify and Upload the LocalSettings.php