Manual:Instalación de MediaWiki
Esta página describe los pasos necesarios para instalar MediaWiki manualmente. Después de la instalación, se pueden encontrar detalles adicionales de configuración en Manual:System administration/es#Configuration.
Para instalar MediaWiki, se necesitan conocimientos básicos de alojamiento web. Es más fácil si tiene algo de experiencia con Apache (software de servidor web), PHP y MySQL/MariaDB (base de datos). Para cualquier pregunta relacionada con la instalación de MediaWiki, pregunte al Project: Support desk (servicio de asistencia técnica del proyecto) o consulte otros lugares listados en Comunicación .
La sección apéndices que figura más adelante ofrece alternativas a la instalación manual, junto con notas de instalación específicas para distintas configuraciones del sistema.
Para un montaje más rápido de MediaWiki en un servidor local, consulte Inicio rápido para el desarrollo local .
Requisitos de instalación
Verifique que su sistema cumpla con los requisitos de instalación.
Asegúrese de verificar también las Notas de lanzamiento de la versión de MediaWiki que planea instalar.
Descarga el software MediaWiki
Descarga el archivo comprimido (.tar) de MediaWiki desde la página oficial de descarga.
Si está utilizando MediaWiki en un entorno de producción, el gestor de versiones ha emitido una fuerte recomendación de que sólo las versiones listadas en el Ciclo de vida de las versiones y su fin de vida como la "versión estable" actual, la "versión heredada" o la "versión de soporte a largo plazo" deben ser utilizadas en un entorno de producción. Las versiones más antiguas pueden contener vulnerabilidades de seguridad críticas y otros errores importantes, incluida la amenaza de una posible pérdida y/o corrupción de datos. La versión estable actual es MediaWiki 1.42.3.
Extraiga el software MediaWiki
El archivo descargado tiene un formato de archivo de .zip
o .tar.gz
.
Debe descomprimir este archivo de almacenamiento antes de usarlo.
Puede descomprimir el archivo localmente (y luego subirlo a través de FTP al servidor) o directamente en su servidor.
En Windows, la descompresión generalmente se realiza con software como 7-Zip (gratis), WinZip, WinRAR o IZArc (gratis).
En Linux y Mac OS X, puede descomprimir el archivo usando el comando:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder>
Para más información sobre la seguridad y permisos de archivos, consulte Manual:Security#File_permissions
Subir archivos a su servidor web
Si aún no ha subido los archivos a su servidor web (o copiado, si el software de su servidor web se ejecuta localmente en su localhost
), hágalo ahora.
Cargue los archivos en el directorio web de su servidor web ya sea por:
- copiando directamente la carpeta descomprimida o
- usando un cliente FTP como FileZilla (Windows, OSX y Linux) o Cyberduck (Windows y OSX).
- mediante el uso de software ya proporcionado por su servicio de alojamiento, como el administrador de archivos cPanel
Si su herramienta de carga tiene la opción "cambiar los nombres de los archivos a minúsculas", debe desactivarla para evitar cualquier modificación no deseada en los nombres de archivo durante el proceso de carga.
Si usa el servidor web Apache HTTPD, el directorio correcto se especifica en su archivo httpd.conf
en la directiva DocumentRoot
.
De forma predeterminada, es /var/www/
o <carpeta-apache>/htdocs
.
La ubicación exacta del archivo de configuración y directorios del servidor Apache httpd.conf
depende de su sistema operativo.
En Debian y Ubuntu, el archivo de configuración y directorios del servidor Apache es /etc/apache2/apache2.conf
.
En Red Hat y Fedora, el archivo es /etc/httpd/conf/httpd.conf
.
Cambie el nombre de la carpeta cargada con el nombre que desee, ya que esto determinará cómo aparecerá en la URL.
Por ejemplo, si cambia el nombre de la carpeta a wiki
, la URL reflejará esto como example.com/wiki
.
Si su servidor web se ejecuta como http://localhost
, por ejemplo, cambiar el nombre del directorio /w/
significaría que accedería a su wiki en http://localhost/w/index.php
.
/wiki/
si desea configurar URLs cortas después de ejecutar el script de configuración inicial.
Configurar la base de datos
El script de configuración inicial de MediaWiki requiere un nombre de base de datos y un nombre de usuario de base de datos para almacenar el contenido de la wiki.
Si ya tiene un servidor de base de datos y conoce la contraseña del usuario "raíz" (administrador), puede pasar directamente a la sección #Ejecutar el script de instalación.
Si no conoce la contraseña del usuario raíz, por ejemplo, si se encuentra en un servidor alojado, deberá crear una nueva base de datos antes de ejecutar el script de instalación de MediaWiki en la siguiente sección.
MariaDB/MySQL son las bases de datos recomendadas. PostgreSQL y SQLite tienen soporte limitado y no deben usarse a menos que haya una razón para hacerlo. Si no está seguro de qué base de datos elegir, use MariaDB.
Después de finalizar la configuración de la base de datos, continúe con #Ejecute el script de instalación a continuación.
SQLite
No se requiere configuración adicional para SQLite si el módulo pdo-sqlite
para PHP está instalado en el sistema.
En la página de instalación de SQLite, elija un nombre de base de datos (que puede ser cualquier cosa) y el directorio de la base de datos de SQLite. Para el directorio de la base de datos, el instalador intentará usar un subdirectorio fuera de la raíz del documento y lo creará si es necesario. Si este directorio no es seguro (por ejemplo, no se puede leer en la web), cámbielo manualmente para evitar que todos puedan acceder a él en la web.
MariaDB/MySQL
Para crear la base de datos y el usuario para MariaDB/MySQL, puede utilizar uno de los siguientes métodos:
- Un panel de control proporcionado por su servicio de alojamiento, como PhpMyAdmin.
- Acceso SSH a su servidor, donde pueda introducir los siguientes comandos en un indicador de MySQL. Consulte la documentación de su proveedor de alojamiento. Alternativamente, puede solicitar que su proveedor de alojamiento cree la base de datos y el usuario para usted.
Los siguientes comandos crearán una base de datos llamada my_wiki
, un usuario llamado wikiuser
, y asignará permisos para el usuario en esa base de datos.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Sólo si su base de datos no se ejecuta en el mismo servidor que su servidor web, debe indicar el nombre del servidor web apropiado (mediawiki.example.com
en el ejemplo siguiente):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
PostgreSQL
Si está utilizando PostgreSQL, deberá tener una base de datos y un usuario creados para usted, o proporcionar el nombre de un usuario de PostgreSQL con privilegios de "superusuario" en el formulario de configuración.
A menudo, este es el usuario de la base de datos llamado postgres
.
Los siguientes comandos en una línea de comandos de Linux, como usuario de postgres, crean un usuario de base de datos denominado wikiuser
y una base de datos denominada my_wiki
propiedad del usuario denominado wikiuser
.
createuser -S -D -R -P -E wikiuser (luego ingrese la contraseña de la base de datos) createdb -O wikiuser my_wiki
o como superusuario (postgres predeterminado) ejecute los siguientes comandos en el indicador de la base de datos:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Tenga cuidado con la lista de problemas conocidos al ejecutar MediaWiki con PostgreSQL.
Ejecute el script de instalación
Luego, complete la instalación de MediaWiki yendo a la URL de su instalación de MediaWiki en su navegador web: Siga las instrucciones en Manual:Script de configuración .
Otra configuración
- Manual:Administración del sistema - Configuración adicional
- Manual:Administradores - Administración de la wiki
¡Manténgase actualizado!
Una vez instalado, asegúrese de mantenerse actualizado con los lanzamientos y mantenga su servidor seguro.
Apéndices
Alternativas a la instalación manual
La instalación manual suele ser el método preferido porque le da al usuario más control y conocimiento sobre cómo se instala su wiki, lo que facilita la resolución de problemas y el mantenimiento. Los procesos, paquetes, paquetes y servicios automatizados vienen con sus propias idiosincrasias.
En lugar de instalar manualmente MediaWiki, las opciones alternativas pueden ser más sencillas:
- dispositivos de software preintegrados
- servicios de alojamiento con instalación con 1 clic o granjas wiki
- Paquetes de software
- Los servicios de alojamiento que brindan la instalación automática de aplicaciones como MediaWiki pueden ofrecer versiones desactualizadas o tener otros problemas. Si encuentra problemas, "no" significa que no puede instalar MediaWiki. Significa que debes instalar MediaWiki manualmente.
Véase también el comparison of distribution options .
Instrucciones específicas del sistema
Las páginas enumeradas en Manual:OS specific help brindan instrucciones de instalación más detalladas dirigidas a sistemas específicos.
Sin embargo, en general, estos documentos por sistema tienen menos mantenimiento y es posible que no siempre estén actualizados. Primero consulte Instalación de MediaWiki (esta página) antes de ver la documentación de instalación por sistema.
Ejecutando múltiples wikis
Consulte las preguntas frecuentes sobre instalación y configuración
Importando una base de datos wiki existente
Lee las preguntas frecuentes sobre instalación y configuración