Manual:Installing MediaWiki/pt-br

O MediaWiki instala-se usando um script interativo, baseado na web. Antes de rodar este script, você precisa fazer algumas coisas: consulte os pré-requisitos ou o guia de instalação resumido para experts.

Pode ser difícil instalar o MediaWiki para um usuário médio, sem experiência com Apache, PHP e MySQL/MariaDB. Most users who wish to use wiki software may benefit from using a free MediaWiki host or via a software bundles.

Para informações para resolução de problemas, consulte Manual:Errors and Symptoms#Installation Errors.

Baixar o software MediaWiki
Você pode baixar uma versão do MediaWiki na página oficial de download: geralmente, se estiver usando um ambiente de produção, você desejará rodar uma versão estável.

Para baixar o MediaWiki, que é a última versão estável lançada, para uma máquina *nix você pode dar o seguinte comando: wget https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz Opcionalmente, usando cURL:

curl -O https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz

Os arquivos baixados estarão no formato, então deverão ser descomprimidos antes de serem usados. Isto pode ser feito localmente (e então subido via FTP) ou diretamente em seu servidor. This is usually done with software such as 7-Zip (free), WinZip, WinRAR or IZArc (free) on Windows. No Linux e Mac OS X, você pode descompactar o arquivo usando este comando:

tar xvzf mediawiki-*.tar.gz

Se você descompactar o arquivo como root, você provavelmente deverá mudar o ownership depois disso, usando chown, senão os arquivos acabarão tendo ownership do usuário # 1000, que pode ou não ser o que você quer.

Para desenvolvedores
Desenvolvedores, por outro lado, provavelmente baixarão via Git para configurar um repositório local com os últimos códigos desenvolvidos. Eles também terão de instalar as dependências manualmente através do Composer.

Upload de arquivos
Se você ainda não subiu os arquivos para seu servidor web, suba agora.

Tenha certeza que a opção de upload "Change file names to lowercase" está desabilitada.

É possível fazer o upload dos arquivos para o diretório de seu servidor web:


 * 1) copiando diretamente a pasta descompactada ou
 * 2) by using an FTP client such as FileZilla (Open Source Software, Windows, OSX and Linux) or Cyberduck (OSX).

Se você instalou o Apache, o diretório correto estará especificado em seu arquivo  (geralmente é a pasta  ). Note: This changes in Ubuntu 14.04 with Apache 2.4.7 where the primary config file for Apache server settings and directories is.

Se você estiver usando um servidor Linux ou Unix você poderá copiar os arquivos para qualquer diretório em seu servidor e então fazer um link simbólico para esta pasta no diretório web do seu servidor.

Renomeie a pasta que subiu como você quiser que seja na URL. If your web server is running as  for example, renaming to   directory would mean you would access your wiki at. Não use  se desejar usá-la como uma Short URL. (e não configure short URLs antes de rodar o script de instalação).

Note que, em certos casos, como quando um repositório local foi configurado usando Git, ao navegar para  o servidor Linux pode exibir o erro "500 Internal server Error". Isto provavelmente é um erro de permissões, que pode ser resolvido mudando as permissões do arquivo e diretório rodando o comando a seguir via SSH, após mudar para o diretório "w": find. -type f -exec chmod 644 {} \; find. -type d -exec chmod 755 {} \;

Esta pasta (renomeada) será agora referenciada como.

Criar uma base de dados
Se você já tem um servidor de base de dados e sabe a senha do root para ele, o instalador do MediaWiki poderá criar uma nova base de dados pra você. Se for esse o caso, pode pular para a seção abaixo Rodar o script de instalação. Se você não sabe a senha de root, por exemplo, se está em um servidor do provedor, você terá de criar uma nova base de dados agora. Atualmente, você deve usar SQLite, MariaDB/MySQL ou PostgreSQL para armazenar o conteúdo de sua wiki.

SQLite
O MediaWiki suporta SQLite desde a versão 1.13, embora pelo menos a versão 1.16 é altamente recomendado. O SQLite é uma bibliodeta de base de dados stand-alone que armazena o conteúdo da base de dados em um único arquivo. Se o PHP tiver o módulo pdo-sqlite, não será necessário efetuar mais configurações.

Na página de instalação, você deverá escolher o nome da base de dados (que pode ser qualquer um) e o diretório da base de dados SQLite. For the database directory, the installer will attempt to use a subdirectory outside of the document root and create it if needed. If this directory is not safe (for example, web-readable), change it manually to avoid making it accessible to everyone on the web.

MariaDB/MySQL
MediaWiki will ask you for database and user name and will attempt to create them if they don't already exist. If doing so from MediaWiki is impossible, you can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. See the corresponding documentation. Alternatively, contact your host provider to have them create an account for you.

Unix/Linux installation

 * 1) Download and install MariaDB/MySQL. Depending on how MariaDB/MySQL was installed on your system the commands ,   and   may need to be amended to include the installation directory of MariaDB/MySQL (for example, by adding   in front of them).
 * 2) Check and see if the database server is running; for example, run  .  If it is not, run mysqld_safe to start it:.
 * 3) * Another way to initially start the MariaDB/MySQL server is to run the configure script available at the root of the installation. It creates the initial tables and automatically starts the MariaDB/MySQL daemon.
 * 4) * Alternatively you can start the MariaDB/MySQL daemon with systemd using: . You may also wish to enable the   service with , so that the MySQL service is started automatically on startup.
 * 5) Set a password for the "root" account on your database server.
 * 6) Run the MariaDB/MySQL command-line client:
 * 7) This will prompt for the "root" database password you just set, then connect to the MariaDB/MySQL server. Now, continue with the SQL commands below.

Windows installation

 * 1) Download MySQL msi (mysql-5.5.22-winx64.msi for example)
 * 2) Run msi file and accept all defaults. When creating the root account, use a password that you will remember.
 * 3) Run Start->All Programs->MySQL->MySQL Server->MySQL Command Line Client
 * 4) Enter the root password you just created
 * 5) Now continue with the instructions below

Installation continued
If your database is not running on the same server as your web server, you need to give the appropriate web server hostname -- mediawiki.example.com in my example -- as follows:

MySQL/MariaDB on UNIX/Linux logs all queries sent to it to a file, which will include the password you used for the user account. If this concerns you, delete your  file after running these queries. This file may be found in your home directory.

PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or simply supply the name of a PostgreSQL user with "superuser" privileges to the configuration form. Often, this is the database user named postgres.

Here's one way to do most of the setup. This is for a Unix-like system. In this example, we'll create a database named wikidb, owned by a user named wikiuser. From the command-line, as the postgres user, perform the following steps.

createuser -S -D -R -P -E wikiuser (then enter the password) createdb -O wikiuser wikidb

or as superuser (default postgres) execute the following commands at the database prompt:

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password'; CREATE DATABASE wikidb WITH OWNER wikiuser;

Beware of the list of known issues when running MediaWiki with PostgreSQL.

Run the installation script
Once all of the above steps are complete, you can complete the installation through a web browser by going to the index.php URI in your browser -- check the instructions mentioned in Special:MyLanguage/Manual:Config script.

If needed, you can run the command-line installer or CLI:.

MediaWiki 1.16 and earlier needed to be able to write to the  directory when it ran its installation script. This is no longer required.

Keep up to date!
Subscribe to our release announcements mailing list.

Once installed, make sure you stay up to date with releases, and keep your server secure!

Installation assistance

 * FAQ: FAQ
 * mediawiki-l (Mailing List) is the high-traffic mailing list to ask for support