Manual:install.php
| MediaWiki file: install.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.44.2 • 1.43.5 • 1.39.15 |
| Classes: | CommandLineInstaller |
Details
editinstall.php file is a CLI-based maintenance script for installing and configuring MediaWiki.
This script creates a new LocalSettings.php and populates the database given.
It will abort if a LocalSettings.php file exists already, and it can't read existing settings from that file.
Usage
editphp maintenance/run.php install [--conf|--confpath|--dbgroupdefault|--dbname|--dbpass|--dbpassfile|--dbpath|--dbport|--dbprefix|--dbschema|--dbserver|--dbtype|--dbuser|--env-checks|--globals|--help|--installdbpass|--installdbuser|--lang|--memory-limit|--pass|--passfile|--profiler|--quiet|--scriptpath|--server|--skins|--wiki|--with-extensions] <name> <admin>
The tables below explain the various options and arguments. The default values for the options are indicated in parentheses.
Generic maintenance parameters:
edit| --help (-h) | Display this help message |
| --quiet (-q) | Whether to suppress non-error output |
| --conf | Location of LocalSettings.php, if not at the default location. This setting has no effect on this script and will be ignored. Use --confpath instead.
|
| --wiki | For specifying the wiki ID |
| --globals | Output globals at the end of processing for debugging |
| --memory-limit | Set a specific memory limit for the script, "max" for no limit or "default" to avoid changing it |
| --server | The protocol and server name to use in URLs, e.g. https://en.wikipedia.org. This is sometimes necessary because server name detection may fail in command line scripts. |
| --profiler | Profiler output format (usually "text") |
Script-dependent parameters
edit| --dbuser | The DB user to use for this script. This value appears in LocalSettings.php for $wgDBuser. If --installdbuser and --installdbpass are given, this value will be used to create a new account
|
| --dbpass | The password to use for this script. This value appears in LocalSettings.php for $wgDBpassword. If --installdbuser and --installdbpass are given, this value will be used to create a new account
|
| --dbgroupdefault | The default database group to use |
Script-specific parameters
edit| Name | Description | Default |
|---|---|---|
| --confpath | Path to write LocalSettings.php to
|
value which by default, corresponds to $IP, i.e. the path of your installation's root folder. You can use --help to find the default value.
You may want to use this if you are adding a new wiki to a wiki family.
After the file has been generated, you can add a LocalSettings.php to the root folder that directs web requests to the wiki-specific LocalSettings.php in your custom path. Do not add it before the file has been generated: regardless what |
| --dbname | The database name | my_wiki |
| --dbpassfile | An alternative way to provide dbpass option, as the contents of this file | |
| --dbpath | The path for the SQLite DB | $IP/data
|
| --dbport | The database port; only for PostgreSQL | 5432 |
| --dbprefix | Optional database table name prefix (not for SQLite) | |
| --dbschema | The schema for the MediaWiki DB in PostgreSQL/Microsoft SQL Server | mediawiki |
| --dbserver | The database host | localhost |
| --dbtype | The type of database | mysql |
| --env-checks | Run environment checks only, don't change anything | |
| --installdbpass | The password for the DB user to install as | |
| --installdbuser | The user to use for installing | root |
| --lang | The language to use | en |
| --pass | The password for the wiki administrator | |
| --passfile | An alternative way to provide pass option, as the contents of this file | |
| --scriptpath | The relative path of the wiki in the web server | /wiki |
| --skins | Comma-separated list of skins to install | all |
| --with-extensions | Detect and include extensions | |
| --with-developmentsettings | Load DevelopmentSettings.php in LocalSettings.php Since MediaWiki 1.42 • change 977136 |
Arguments
edit| <name> | The name of the wiki |
| <admin> | The username of the wiki administrator |
Examples
editSet up wiki using a user with required permissions in database to create a new database for the wiki called "Wiki Name" and a user called "Admin" to operate the wiki:
php maintenance/run.php install \
--dbname=wikidb \
--dbserver="localhost" \
--installdbuser=root \
--installdbpass=rootpassword \
--dbuser=dbusername \
--dbpass=dbuserpassword \
--server="http://wiki.example.com/" \
--scriptpath=/w \
--lang=en \
--pass=Adminpassword "Wiki Name" "Admin"
See also
edit- installPreConfigured.php - alternative install script introduced in MediaWiki 1.44 which retrieves configuration details from an existing LocalSettings.php.