Manual:Configurando o MediaWiki

Essa página encobre todos os passos necessários para instalar o MediaWiki. Depois da instalação, detalhes adicionais de configuração podem ser encontrados em Manual:Administração de Sistema#Configuração.

Para instalar a MediaWiki, é necessário um conhecimento básico em hospedagem web. Será mais fácil se você já possuir alguma experiência com Apache (servidor web), PHP e MySQL/MariaDB (banco de dados) Para qualquer dúvidas referentes as instalações da MediaWiki, pergunte Project: Support desk ou busque referências em outros lugares listados em Comunicação .

A seção Apêndices abaixo mostra algumas alternativas a instalação manual, junto com notas de instalação específicas para diferentes configurações de sistema.

Para obter uma configuração mais rápida do servidor local do MediaWiki, consulte Local development quickstart .

Verifique se o seu sistema corresponde aos requisitos de instalação.

Certifique-se também de verificar as Notas de lançamento da versão do MediaWiki que você planeja instalar.

Baixe o arquivo tar do MediaWiki da página oficial de download.

Se você estiver usando o MediaWiki em um ambiente de produção, o gerenciador de versões emite uma forte recomendação de que apenas as versões listadas em Ciclo de vida da versão e seu fim de vida útil como a atual "versão estável", "versão legada" ou "versão de suporte de longo prazo" devem ser usadas em um ambiente de produção. As versões mais antigas podem conter vulnerabilidades críticas de segurança e outros erros importantes, incluindo a ameaça de possível perda e/ou corrupção de dados. A versão estável atual é MediaWiki 1.43.1.

O arquivo baixado está no formato de arquivo .zip ou .tar.gz. Você precisa descompactar este arquivo antes de usá-los. Você pode descompactar o arquivo localmente (e depois carregá-lo via FTP para o servidor) ou diretamente no seu servidor.

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

No Linux e macOS, você pode descompactar o arquivo usando este comando: tar -xzvf mediawiki-*.tar.gz

Se você ainda não carregou os arquivos para o seu servidor web (ou copiou, se o software do seu servidor web é executado localmente no seu localhost), faça-o agora.

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

1. copiando diretamente a pasta descompactada ou
2. usando um cliente FTP como FileZilla (Windows, OSX e Linux) ou Cyberduck (Windows e OSX).
3. usando software já fornecido pelo seu serviço de hospedagem, como o 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 para evitar quaisquer modificações não intencionais nos nomes dos arquivos durante o processo de carregamento.

Se você usar o servidor web Apache HTTPD, o diretório correto será especificado em seu arquivo httpd.conf na diretiva DocumentRoot. Por padrão, isso é /var/www/ ou <pasta-do-apache>/htdocs.

A localização exata do arquivo httpd.conf de configurações e diretórios do servidor Apache depende do seu sistema operacional. No Debian e no Ubuntu, o arquivo de configurações e diretórios do servidor Apache é /etc/apache2/apache2.conf. No Red Hat e no Fedora, o arquivo é /etc/httpd/conf/httpd.conf.

Renomeie a pasta enviada para o nome pretendido, pois isso determinará como aparecerá na URL. Por exemplo, se renomear a pasta para wiki, a URL refletirá isso como example.com/wiki. Se o seu servidor web estiver sendo executado como http://localhost , por exemplo, renomear para o diretório /w/ significaria que você acessaria sua wiki em http://localhost /w/index.php.

O script de configuração inicial do MediaWiki precisa de um nome de banco de dados e um nome de usuário do banco de dados para armazenar o conteúdo da wiki.

Se você já possui um servidor de banco de dados e sabe a senha do usuário "root" (administrador), você poderá ir à seção #Executar o script de instalação.

Se você não souber a senha do usuário root, por exemplo, se você estiver utilizando um servidor hospedado, você precisará criar um novo banco de dados antes de proceder à seção do script de instalação do MediaWiki.

MariaDB/MySQL são os bancos de dados recomendados. PostgreSQL e SQLite têm suporte limitado e não devem ser usados a menos que haja uma razão para isso. Se não tiver certeza de qual banco de dados escolher, use MariaDB.

Após terminar a configuração do banco de dados, continue com #Executar o script de instalação abaixo.

Nenhuma configuração adicional é necessária para SQLite se o módulo pdo-sqlite para PHP estiver instalado no sistema.

Na página de instalação do SQLite, escolha um nome de banco de dados (que pode ser qualquer coisa) e o diretório do banco 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.

Crie o banco de dados MariaDB/MySQL e o usuário do banco de dados.

• Um painel de controle oferecido pelo seu serviço de hospedagem como, phpMyAdmin.
• Use ssh para fazer login em seu host e digite os comandos abaixo em um prompt do MySQL. Consulte a documentação correspondente do seu provedor de hospedagem. Alternativamente, você pode solicitar ao seu provedor de hospedagem que crie a base de dados e o usuário para você.

Os comandos a seguir criam um banco de dados chamado my_wiki, um usuário chamado wikiuser e definem permissões para o usuário nesse banco de dados.

CREATEDATABASEmy_wiki;
CREATEUSER'wikiuser'@'localhost'IDENTIFIEDBY'database_password';
GRANTALLPRIVILEGESONmy_wiki.*TO'wikiuser'@'localhost'WITHGRANTOPTION;

Somente se o seu banco de dados não estiver sendo executado no mesmo servidor que o seu servidor web, você precisará fornecer o nome de host do servidor web apropriado (mediawiki.example.com no exemplo abaixo):

GRANTALLPRIVILEGESONmy_wiki.*TO'wikiuser'@'mediawiki.example.com'IDENTIFIEDBY'database_password';

Se você estiver usando PostgreSQL, você precisará ter um banco de dados e um usuário criados para você ou fornecer o nome de um usuário PostgreSQL com privilégios de "superusuário" no formulário de configuração. Com frequência, este é o usuário do banco de dados chamado postgres

Os seguintes comandos em uma linha de comando Linux, como usuário postgres, criam um usuário de banco de dados chamado wikiuser, e um banco de dados chamado my_wiki de propriedade do usuário chamado wikiuser.

 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:

CREATEUSERwikiuserWITHNOCREATEDBNOCREATEROLENOSUPERUSERENCRYPTEDPASSWORD'database_password';
CREATEDATABASEmy_wikiWITHOWNERwikiuser;

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

Em seguida, conclua a instalação do MediaWiki acessando a URL de instalação do MediaWiki em seu navegador: Siga as instruções em Manual:Comando de Configuração .

• Manual:Administração do sistema - Configuração adicional
• Manual:Administradores - Administração da Wiki

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

Inscreva-se na lista de anúncios de lançamentos do MediaWiki

A instalação manual costuma ser o método preferido porque dá ao usuário mais controle e informações sobre como sua wiki é instalada, facilitando a solução de problemas e a manutenção. Processos, pacotes, conjuntos e serviços automatizados vêm com suas próprias idiossincrasias.

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
• Pacotes de software

Ao criar uma conta root, use uma senha que você se lembrará.

Consulte também o comparison of distribution options

As páginas listadas em Manual:Ajuda específica do sistema operacional 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 Configurando o MediaWiki (esta página) antes de examinar a documentação de instalação por sistema.

Consultar Manual:FAQ#Instalação e configuração.

Consultar Manual:FAQ#Instalação e configuração.

• Atualização
• Desinstalação

• Installation/pt-br
• MediaWiki administration/pt-br