Manual:Installing MediaWiki/pt-br

This page covers all steps to manually install and configure MediaWiki.

Pode ser difícil instalar o MediaWiki para um usuário médio, sem experiência com Apache, PHP e MySQL/MariaDB. The Appendices section below offers easier alternatives to manual installation.

The Appendices section below also provides installation notes for specific system configurations.

Check the installation requirements
Check that your system meets the installation requirements.

Make sure to also check the of the MediaWiki version that you plan to install.

Baixar o software MediaWiki
Baixe o arquivo tar do MediaWiki da página oficial de baixar.

Geralmente, se estiver usando um ambiente de produção, você deseja executar a versão estável mais recente, que é MediaWiki.

Extract the MediaWiki software
Os arquivos baixados estarão no formato, então deverão ser descomprimidos antes de serem usados. You need to uncompress this archive file before use. Isto pode ser feito localmente (e então subido via FTP) ou diretamente em seu servidor.

No Windows, a descompactação pode ser feita com programas como 7-Zip (grátis), WinZip, WinRAR ou IZArc (grátis).

No Linux e Mac OS X, você pode descompactar o arquivo usando este comando:

Fazer upload de arquivos para seu sevidor
Se você ainda não carregou os arquivos para seu servidor web, carregue agora.

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


 * 1) copiando diretamente a pasta descompactada ou
 * 1) usando um cliente FTP como FileZilla (Software de código aberto, com versões para Windows, OSX e Linux) ou Cyberduck (OSX).
 * 1) by using software already provided by your hosting service, such as the cPanel File Manager

Se sua ferramenta de carregamento tiver uma opção "alterar nomes de arquivo para minúsculas", então você deve desabilitar isso.

Se você instalou o Apache, o diretório correto é especificado em seu  file (é o diretiva, tipicamente $1 ou ). By default, this is  or.

The exact location of the Apache server settings and directories file  depends on your operating system. Nota: Isso mudou em Ubuntu 14.04 com Apache 2.4.7 onde o arquivo de configuração primário para configurações e diretórios do servidor Apache é. In Red Hat and Fedora, the file is.

Renomeie a pasta que subiu como você quiser que seja na URL. Se seu servidor web estiver rodando como  por exemplo, ao renomear o diretório para   significará que você acessará seu wiki em.

Definir o banco de dados
O MediaWiki solicitará a base de dados e nome de usuário, e tentará criá-los, se não existirem ainda.

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 você não souber a senha do usuário root, por exemplo, se você estiver em um servidor hospedado, você terá que criar um novo banco de dados antes de executar o script de instalação do MediaWiki na próxima seção.

SQLite, MariaDB/MySQL, e PostgreSQL são bancos de dados com suporte. Se você não tiver certeza sobre qual banco de dados escolher, use o MariaDB, pois é o melhor suportado pelo MediaWiki.

After finishing the database setup, continue with below.

SQLite
No further setup is required for SQLite if the  module for PHP is installed on the system.

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. Para o diretório da base de dados, o instalador tentará usar um subdiretório fora do document root, e irá criá-lo se necessário. Se este diretório não for seguro (por exemplo, puder ser lido via web), mude-o manualmente para evitar que fique acessível a todos na web.

MariaDB/MySQL
Create the MariaDB/MySQL database and database user. There are several ways:


 * Use a control panel software offered by your Hosting service (example: PhpMyAdmin)
 * Use ssh to log into your host and type the commands below into a MySQL prompt. Consulte a documentação correspondente. Opcionalmente, entre em contato com seu provedor para que eles criem esta conta para você.

The following commands create a database named, a user named  , and set permissions for the user on that database.

Se sua base de dados não estiver rodando no mesmo servidor de ser servidor web, você precisará fornecer o hostname de seu servidor web -- mediawiki.example.com no meu exemplo -- como se segue:

PostgreSQL
Se você estiver usando o PostgreSQL, precisará, ou ter uma base de dados e usuário já criados para você, ou simplesmente fornecer o nome de um usuário do PostgreSQL com privilégios de "superusuário" para efetuar a configuração. Com frequência, este é o usuário do banco de dados chamado Os seguintes comandos em uma linha de comando Linux, como usuário postgres, criam um usuário de banco de dados chamado, e um banco de dados chamado   de propriedade do usuário chamado.

createuser -S -D -R -P -E wikiuser (então insira a senha) createdb -O wikiuser my_wiki

ou como superusuário (que por padrão é postgres) execute os seguintes comandos no prompt da base de dados:

Atenção para a lista de problemas conhecidos ao rodar o MediaWiki com PostgreSQL.

Executar o script de instalação
Uma vez completados os passos acima, você poderá completar a instalação através do navegador de internet, acessando a URI index.php em seu navegador -- verifique as instruções mencionadas em.

Configuração extra

 * - Configuração adicional
 * - Administração da Wiki

Mantenha atualizado!
Uma vez instalado, tenha certeza de manter atualizado, e manter seu servidor seguro!

Alternativas à instalação manual
Em vez de instalar o MediaWiki manualmente, as opções alternativas podem ser mais fáceis:
 * dispositivos de software pré-integrados
 * serviços de hospedagem com instalação em 1 clique, ou wiki farms

Consulte também o

Instruções específicas do sistema
As páginas listadas em fornecem instruções de instalação mais detalhadas destinadas a sistemas específicos.

Entretanto, na maioria dos casos, estes documentos por sistema são menos conservados e nem sempre podem estar atualizados. Primeiro consulte (esta página) antes de examinar a documentação de instalação por sistema.

Executando múltiplas wikis
Consultar Manual:FAQ#Instalação e configuração.

Importar uma base de dados wiki existente
Consultar Manual:FAQ#Instalação e configuração.