View source for Manual:Config script

<languages/>
{{InstallationNav}}
<translate><!--T:1--> After downloading and extracting MediaWiki on your web server, complete the basic setup by running the configuration script. This script allows you to tell MediaWiki the information it needs in order to get the wiki up and running.</translate>
<translate><!--T:123--> The following steps describe how to complete basic setup:</translate>

<translate>
== Running the MediaWiki configuration script in the web browser == <!--T:124-->
</translate>
[[File:MediaWiki_1.38.2_Config_script_2.png|thumb|{{dir|{{pagelang}}|left|right}}|250px|<translate><!--T:133--> MediaWiki 1.38 web installer</translate>]]
<translate><!--T:3--> In the following examples, it is assumed that your website is located at <tvar name=1><code><nowiki>http://www.example.com/</nowiki></code></tvar>.</translate>
<translate><!--T:125--> The physical location on your server depends on your web server software configuration.</translate>
<translate><!--T:126--> Adjust the examples as needed.</translate>

# <translate><!--T:118--> Open a web browser and browse to the website address or path that you configured for MediaWiki in the web server software.</translate>
# <translate><!--T:91--> You will see the version of MediaWiki which you extracted and a link to "Please set up the wiki first."</translate> <translate><!--T:111--> Click on the link to begin the configuration script.</translate><br/><translate><!--T:112--> For reference (in case you want to go there directly), this is located in MediaWiki's <tvar name=1><code>mw-config</code></tvar> directory (so using the example above you would go to <tvar name=2><code><nowiki>http://www.example.com/mw-config/</nowiki></code></tvar>, or on a local machine <tvar name=localhost><code><nowiki>http://localhost/mw-config/</nowiki></code></tvar>).</translate>
# <translate><!--T:119--> After selecting the language, the configuration script performs some environmental checks.</translate>
# <translate><!--T:122--> Follow the instructions on the pages to connect to the database, create the MediaWiki administrator account, and to set further settings such as the logo or skin.</translate><!--
-->{{Note|type=reminder|1=<translate><!--T:86--> Since <tvar name=1><code>{{ll|Manual:LocalSettings.php|LocalSettings.php}}</code></tvar> stores the database user's ''password in plain text'', it is strongly suggested that you create a wiki specific database account (i.e. not root).</translate>}}
# <translate><!--T:10--> The script will populate the database and write a configuration file.</translate>
# <translate><!--T:11--> After the configuration script has finished, download the generated configuration file <tvar name=1><code>{{ll|Manual:LocalSettings.php|LocalSettings.php}}</code></tvar> and place the file in the base directory of your MediaWiki installation.</translate>
<translate><!--T:85--> <tvar name=1><code>{{ll|Manual:LocalSettings.php|LocalSettings.php}}</code></tvar> contains all the information needed by MediaWiki to run.</translate>
{{Note|type=warning|1=<translate><!--T:95--> Set stringent file permissions which system users can read and write the <tvar name=1><code>LocalSettings.php</code></tvar> file.</translate><br/><translate><!--T:96--> For example, set <code>[[w:chmod|chmod 600]]</code> and <code>[[w:chown|chown]] &lt;webserver owner></code> (Owner read and write, no other permissions).</translate>}}

<translate>
<!--T:13-->
Your wiki should now be ready to use. Browse to the address that you installed MediaWiki to.

<!--T:127-->
Continue with more advanced configuration on <tvar name=1>{{ll|Manual:System administration}}</tvar>.

== Command-line alternative == <!--T:131-->

<!--T:132-->
Alternatively, you can run a command-line installer instead of the configuration script in the web browser.

<!--T:134-->
There are several installers available which you can use based on your needs:
</translate>

* <code>php ./maintenance/run.php {{ll|Manual:Install.php|install}}</code> – <translate><!--T:135--> Creates a new <tvar name=1><code>LocalSettings.php</code></tvar> using CLI parameters.</translate>
* <code>php ./maintenance/run.php {{ll|Manual:InstallPreConfigured.php|installPreConfigured}}</code> – <translate><!--T:136--> Uses an existing <tvar name=1><code>LocalSettings.php</code></tvar> file to retrieve configuration.</translate> <translate><!--T:137--> Useful for wiki farms and docker setups.</translate>

[[Category:Installation{{#translation:}}|{{PAGENAME}}]]