Manual:Installing MediaWiki/ko

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

미디어위키는 Apache, PHP, 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.

미디어위키 소프트웨어 다운로드
공식 다운로드 페이지에서 미디어위키 tar 파일 다운로드합니다.

일반적으로 프로덕션 환경을 사용하는 경우, 최신 안정 릴리즈인 MediaWiki 을 실행하길 원합니다.

Extract the MediaWiki software
다운로드한 파일은  파일 형식이며, 사용하기 전에 압축을 풀어야 합니다. You need to uncompress this archive file before use. You can uncompress the file locally (and then upload via FTP to the server) or directly on your server.

On Windows, uncompressing is usually done with software such as 7-Zip (free), WinZip, WinRAR or IZArc (free).

On Linux and Mac OS X, you can uncompress the file using the command:

파일을 업로드하기
If you have not already uploaded the files to your web server (or copied, if your web server software runs locally on your ), do so now.

Upload the files to your web server's web directory either by:


 * 1) directly copying the unzipped folder or
 * 1) by using an FTP client such as FileZilla (Windows, OSX and Linux) or Cyberduck (Windows and OSX).
 * 1) by using software already provided by your hosting service, such as the cPanel File Manager

If your upload tool has a "change file names to lowercase" option, then you must disable this.

If you use the Apache HTTPD web server, the correct directory is specified in your  file in the  directive. By default, this is  or.

The exact location of the Apache server settings and directories file  depends on your operating system. In Debian and Ubuntu, the file for Apache server settings and directories is. In Red Hat and Fedora, the file is.

Rename the uploaded folder to whatever you would like to have in the URL. If your web server is running as  for example, renaming to   directory would mean you would access your wiki at.

데이터베이스 만들기
MediaWiki's installation script will ask you for a database name and database username, so MediaWiki can store the content of the wiki.

If you already have a database server and know the password for the "root" (admin) user, skip to the #Run the installation script section below.

If you don't know the password for the root user, for example if you are on a hosted server, you will have to create a new database before you run the MediaWiki installation script in the next section.

SQLite, MariaDB/MySQL, and PostgreSQL are supported databases. If you're unsure which database to choose, use MariaDB.

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.

On the SQLite installation page, choose a database name (which can be anything) and the SQLite database directory. 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
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. See the corresponding documentation of your hosting provider. Alternatively, contact your hosting provider to have them create an account for you.

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

Only if your database is not running on the same server as your web server, you need to give the appropriate web server hostname ( in the example below):

PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or supply the name of a PostgreSQL user with "superuser" privileges to the configuration form. Often, this is the database user named. The following commands on a Linux command-line, as the postgres user, create a database user named, and a database named   owned by the user named.

createuser -S -D -R -P -E wikiuser (저기에 비밀번호를 입력하세요) createdb -O wikiuser my_wiki

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

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

설치 스크립트 실행
Next, complete the installation of MediaWiki by going to the URL of your MediaWiki installation in your web browser: Follow the instructions in.

Further configuration

 * - Additional configuration
 * - Wiki administration

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

Alternatives to manual installation
Instead of manually installing MediaWiki, alternative options might be easier:
 * pre-integrated software appliances
 * hosting services with 1-click installation, or wiki farms

See also the.

System-specific instructions
The pages listed on give more detailed installation instructions aimed at specific systems.

However, by and large these per-system docs are less maintained and might not always be up to date. First consult (this page) before looking at per-system installation documentation.

Running multiple wikis
Refer to Manual:FAQ#Installation and configuration.

Importing an existing wiki database
Refer to Manual:FAQ#Installation and configuration.