Manual:install.php
From mediawiki.org
Languages:
| MediaWiki file: install.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.44.2 • 1.43.5 • 1.39.15 |
| Classes: | CommandLineInstaller |
Details
[edit ]install.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
[edit ]phpmaintenance/run.phpinstall[--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 corresponding to $IP, i.e. the path of your installation's root folder.
You can use |
| --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
[edit ]Set 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"