Ubuntu

12.04

<span class="warning"><p></p>

<div name="status-deprecated" data-unique="status-deprecated"></div><h2 id="status-deprecated"><strong>Status:</strong> Deprecated</h2>

<p>This article covers a version of Ubuntu that is no longer supported.  If you are currently operate a server running Ubuntu 12.04, we highly recommend upgrading or migrating to a supported version of Ubuntu:</p>

<ul>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-upgrade-ubuntu-12-04-lts-to-ubuntu-14-04-lts">Upgrade to Ubuntu 14.04</a>.</li>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-upgrade-to-ubuntu-16-04-lts">Upgrade from Ubuntu 14.04 to Ubuntu 16.04</a></li>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-migrate-linux-servers-part-1-system-preparation">Migrate the server data to a supported version</a></li>
</ul>

<p><strong>Reason:</strong>
<a href="https://lists.ubuntu.com/archives/ubuntu-announce/2017-March/000218.html">Ubuntu 12.04 reached end of life (EOL) on April 28, 2017</a> and no longer receives security patches or updates.  This guide is no longer maintained.</p>

<p><strong>See Instead:</strong><br>
This guide might still be useful as a reference, but may not work on other Ubuntu releases.  If available, we strongly recommend using a guide written for the version of Ubuntu you are using.   You can use the search functionality at the top of the page to find a more recent version.<br></p></span><h3>About MediaWiki</h3>
<p>MediaWiki is a free open source wiki program that allows users to create their own personal wiki sites. Originally built for Wikpedia, MediaWiki is written in PHP and uses a backend database, like MySQL, to store its data.</p> 

<h2>Setup</h2>

<p>The steps in this tutorial require the user to have root privileges. You can see how to set that up in the <a href="https://www.DigitalOcean.com/community/articles/initial-server-setup-with-ubuntu-12-04">here</a> Initial Server Setup Tutorial.</p> 

<p>Before working with MediaWiki, you need to have LAMP installed on your server. If you don't have the Linux, Apache, MySQL, PHP stack on your server, you can find the tutorial for setting it up <a href="https://www.digitalocean.com/community/articles/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu">Ubuntu LAMP Installation Tutorial</a>.</p> 

<p>Once you have the user and required software on the virtual private server, you can start installing MediaWiki!</p>


<h2>Install Media Wiki</h2>

<p>Because the apt-get package of MediaWiki is very out of date, MediaWiki should be installed from source. We can start off by downloading the latest version:</p>

<pre>curl -O http://dumps.wikimedia.org/mediawiki/1.19/mediawiki-1.19.2.tar.gz</pre>

<p>After it downloads, untar the package:</p>
 
<pre>tar xvzf mediawiki-*.tar.gz</pre>

<p>Move the contents of the MediaWiki directory to a a more convenient location:</p>

<pre>sudo mv mediawiki-1.19.2 /etc/mediawiki</pre>

<p>Create a symbolic link between the MediaWiki directory and Apache’s document root:</p>

<pre>sudo ln -s /etc/mediawiki/ /var/www</pre>

<p>And finish up by restarting apache.</p> 

<pre>sudo service apache2 restart</pre>

<h3>Create a MySQL User and Database</h3>

<p>Although this step is not required for a successful installation of MediaWiki, it is definitely a recommended  measure for added security.</p>  

<p>During the installation process, you will be asked to supply either a database and associated user for a MediaWiki database or your MySQL root password. MediaWiki uses this information to create the required wiki database and tables.Setting up a dedicated database can be done very quickly and removes the need for sharing the MySQL root information and the associated security risks. We can go ahead and set up the database now:</p>

<p>Log into MySQL on your VPS:</p>

<pre>mysql -u root -p</pre>

<p>Once you are logged in, create your MediaWiki database. The default name that MediaWiki has in their configuration form is my_wiki, but you can name it whatever you prefer:</p>

<pre>create database my_wiki;</pre>

<p>Additionally, you will need to provide a user for the new database with the permissions that MediaWiki requires (replace the username and password below with details of your choice):</p> 

<pre>grant index, create, select, insert, update, delete, alter, lock tables on my_wiki.* to 'wikiuser'@'localhost' identified by 'password';</pre>

<p>Finish up by implementing the changes and quitting MySQL:</p>

<pre>FLUSH PRIVILEGES;
exit;</pre>

<p>The next part of the installation needs to be completed through the onscreen instructions located at <b>[domain]/mediawiki/index.php</b></p>


<h2>Set Up MediaWiki</h2>

<p>Go through and fill out the Media Wiki Site configuration in the browser.</p> 

<p>When you reach the “MySQL settings” section of the setup page, leave the Database Host as localhost and then enter in the MySQL database name and username and password, if you configured them in the previous step. If you did not set up a new user for MediaWiki, write in root for the username and the root password in the password field.</p>

<p>You can leave the “MySQL specific options” section as is.</p>

<p>Once you have finished walking through the the configuration,  keep pressing continue until you reach the page that says, “Complete!”</p>
 
<img src="https://assets.digitalocean.com/tutorial_images/fPwcV.png" alt="Complete!">

<p>The LocalSettings.php file should start downloading automatically. Make sure that you have downloaded the file before closing out of the page. LocalSettings.php is auto-generated—if you do not have the Local Settings file, you will have to generate it once again by going through all of the MediaWiki setup steps.</p>

<p>Once the file downloads, you should upload it to  /etc/mediawiki, or whichever directory contains MediaWiki’s “index.php” file on your virtual server.</p> 

<p>You can copy the LocalSettings.php file from your computer to the server, with SCP (Secure Copy), an SSH-based way of transferring files:</p>

<pre>scp /path/to/LocalSettings.php [username]@[IP Address]:/etc/mediawiki</pre>

<p>After the file is uploaded, you will be able to access your personal wiki at <b>[domain]/mediawiki</b></p>

<h2>See More</h2>

<p>This has been a brief overview of how to install MediaWiki. If you have any specific questions about MediaWiki, feel free to ask them in our <a href= "https://www.digitalocean.com/community/questions">Q & A Forum</a></p>

<div class="author">By Etel Sverdlov</div>

This tutorial describes how to install MediaWiki on Ubuntu 12.04, including the steps needed to set up a MySQL database and user. MediaWiki is a free open source wiki program that allows users to create their own personal wiki sites. Originally built for Wikpedia, MediaWiki is written in PHP and uses a backend database, like MySQL, to store its data. 

How To Install MediaWiki on Ubuntu 12.04

How To Install MediaWiki

CentOS

### Introduction

MediaWiki is a free and open-source wiki application written in PHP. It was originally created for WikiPedia, but it now allows everyone to create their own wiki sites. Currently thousands of websites are running MediaWiki, including Wikipedia, Wiktionary and Wikimedia Commons. MediaWiki's homepage is located at [https://www.mediawiki.org](https://www.mediawiki.org/wiki/MediaWiki).

This tutorial goes through how to set up MediaWiki on a CentOS 7 Droplet.

## Prerequisites

* A CentOS 7 server with SSH access. For more information, visit [this tutorial](https://www.digitalocean.com/community/tutorials/initial-server-setup-with-centos-7).
* A LAMP stack, which you can install by following [this tutorial](https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-centos-7).

## Step 1 — Setting Up Your Server

After you have installed the LAMP stack, we will first need to install a few additional PHP 5 modules. All of them are optional except for the first one (the XML extension).

The first one we will be installing is the [XML](http://php.net/manual/en/book.xml.php) extension, and it is required for MediaWiki to run:

```
sudo yum install php-xml
```

The second one we will be installing is the [Intl](http://php.net/manual/en/book.intl.php) extension, for internationalization support:

```
sudo yum install php-intl
```

Secondly, we will install [GD](http://php.net/manual/en/book.image.php) for image thumbnailing:

```
sudo yum install php-gd
```

These last two modules are really optional. These are not necessary for most wikis, unless you have a high performance or math-heavy wiki. The first one is Tex Live for in-line display of mathematical formulae:

```
sudo yum install texlive
```

For added performance, you can install XCache. For this, however, you also need to install an extra repository, as XCache is not available in the CentOS repository by default:

```
sudo yum install epel-release
```

Now, you can install XCache:

```
sudo yum install php-xcache
```

To finish these installations, restart Apache HTTPD.

```
sudo systemctl restart httpd.service
```

## Step 2 — Downloading MediaWiki

In this section we will download MediaWiki from source. MediaWiki can be downloaded from its official website. At time of writing, the latest version is **1.24.1**, but you can double check via the download link on [this page](https://www.mediawiki.org/wiki/Download).

Download MediaWiki.

```
curl -O http://releases.wikimedia.org/mediawiki/1.24/mediawiki-1.24.1.tar.gz
```

Untar the package:

```
tar xvzf mediawiki-*.tar.gz
```

Move to the `/var/www` directory:

```
sudo mv mediawiki-1.24.1/* /var/www/html
```

## Step 3 — Creating a Database

In this section we will set up a MySQL database. This is not strictly required to successfully install MediaWiki, as you can use a SQLite database as well. Despite this, it is definitely a recommended measure.

We will first log in to the MySQL shell:

```
mysql -u root -p
```

This will change your prompt to `MariaDB [(none)]>`.

Now, we will create the database. The database name does not matter for MediaWiki, but we will use `my_wiki` in this tutorial. You can choose another name if you prefer.


```
CREATE DATABASE <^>my_wiki<^>;
```

The output should be:

```
Query OK, 1 row affected (0.00 sec)
```

We don't want to use the `root` user for MediaWiki, so we will create a new database user:

```
GRANT INDEX, CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, LOCK TABLES ON <^>my_wiki<^>.* TO '<^>sammy<^>'@'localhost' IDENTIFIED BY '<^>password<^>';
```

Change `my_wiki` to your chosen database name, `sammy` to your username, and `password` to a secure password. The output should be:

```
Query OK, 0 rows affected (0.01 sec)
```

Next, we need to flush the MySQL privileges:

```
FLUSH PRIVILEGES;
```

The output should be:

```
Query OK, 0 rows affected (0.00 sec)
```

Last, we will need to exit the MySQL shell:

```
exit;
```

The output should be:

```
Bye
```

## Step 4 - Setting Up MediaWiki

In this section, we will set up MediaWiki so it is ready to use. Visit the homepage of your Droplet in your browser by pointing your browser to `http://<^>your_server_ip<^>`. On this page, select **set up the wiki**.

On the first page, select a language and click **Continue**. The next page should show your environment and it should say in green: **The environment has been checked. You can install MediaWiki.** Click **Continue**.

You will now get to the page with MySQL settings. For the **Database type** select **MySQL (or compatible)**. For the database host, type **localhost**. The database name, username, and password will be the values you chose before. We used `my_wiki` for the database name, `sammy` for the username, and `badpassword` for the password. The table prefix can be left empty. It will look like this:

![MySQL settings](https://assets.digitalocean.com/articles/mediawiki_centos7/1.png)

In the screen after the MySQL settings, the values can be left at their defaults. In the next screen, you will need to fill in the details of your wiki, like its name. You can also create the admin user for the wiki on this page.

In all the other screens, most, if not all, of the settings can be left untouched. If you want a specific setting enabled for your wiki, you might need to change something on one of these screens. Particularly if you have installed XCache before, you will need to check that to enable it.

When you have completed all steps, you should arrive at this page:

![Completed installation](https://assets.digitalocean.com/articles/mediawiki_centos7/2.png)

To successfully complete the installation, you will need to move a file called `LocalSettings.php` to your server, which should have started downloading automatically. You should download this file before closing the page.

Now, you will need to upload the file to `/var/www/html`. You could use an external program, but it is easiest to open the file on your local computer, copy the contents and paste them into your SSH session. To do this, first open the file on the server:

```
sudo nano /var/www/html/LocalSettings.php
```

Now, open the file on your computer in your text editor of choice and copy the contents into your SSH window. After you have saved the file, you can click **enter your wiki** and your wiki should be ready to use.

### Conclusion

You will now see your own MediaWiki installation, ready for use. To further customize the page, visit the [System administration](http://www.mediawiki.org/wiki/Manual:System_administration) page on the MediaWiki homepage. You can also start adding pages directly.

MediaWiki is a free and open-source wiki application written in PHP. It was originally created for WikiPedia, but it now allows everyone to create their own wiki sites. This tutorial goes through how to set up MediaWiki on a CentOS 7 Droplet.

How To Install MediaWiki on CentOS 7

<$>[warning]
## Status: Deprecated

This article covers a version of CentOS that is no longer supported. If you are currently operating a server running CentOS 6, we highly recommend upgrading or migrating to a supported version of CentOS. 

**Reason**:
[CentOS 6 reached end of life (EOL) on November 30th, 2020](https://wiki.centos.org/About/Product) and no longer receives security patches or updates. For this reason, this guide is no longer maintained.

**See Instead**:
This guide might still be useful as a reference, but may not work on other CentOS releases. If available, we strongly recommend using a guide written for the version of CentOS you are using.

The following DigitalOcean tutorial may be of immediate interest, as it outlines installing MediaWiki on a CentOS 7 server:

* [How To Install MediaWiki on CentOS 7](https://www.digitalocean.com/community/tutorials/how-to-install-mediawiki-on-centos-7)

<$>

### Mediawiki
---
MediaWiki is a free open source wiki program that allows users to create their own personal wiki sites. Originally built for Wikpedia, it is now used by thousands of other projects due to its scalability and high customization. 

Before working with MediaWiki, you need to have LAMP installed on your server. If you don't have the Linux, Apache, MySQL, PHP stack on your server, you can find the tutorial for setting it up here: <a href="https://www.digitalocean.com/community/articles/how-to-install-linux-apache-mysql-php-lamp-stack-on-centos-6">CentOS LAMP Installation Tutorial</a>. <br/><br/>

## Install MediaWiki on your VPS
---
At the time of writing, the latest version of MediaWiki is **MediaWiki 1.21.2**. To check for the latest version of the platform, visit their [website](http://www.mediawiki.org/wiki/Download) and simply alter the code to match the most updated version (if desirable).

<ul>
<li>Go to MediaWiki’s official website and download the latest version of the platform:</li>
<pre>wget http://download.wikimedia.org/mediawiki/1.21/mediawiki-1.21.2.tar.gz</pre>
<li>After the download completes untar the package:</li>
<pre>tar xvzf mediawiki-*.tar.gz</pre>
<li>The default directory for the downloaded contents includes the specified version of the platform-- it may be best to move the contents to a more convenient location:</li>
<pre>sudo mv mediawiki-1.21.2 /etc/mediawiki</pre>
<li>Create a symbolic link between the MediaWiki directory and Apache’s document root:</li>
<pre>sudo ln -s /etc/mediawiki/ /var/www/html</pre>
<li>Restart Apache</li>
<pre>sudo service apache2 restart</pre>
</ul>

## Create a MySQL Database and User
---

Creating a MySQL database is simple and increases security, as it eliminates the need for sharing the MySQL root information. Follow these steps:

<ul>
<li>Log into MySQL</li>

<pre>mysql -u root -p</pre>

<li>Create a Dedicated Database</li><br/>
You can name your DB whatever you'd like-- here it will be **example_wiki**.

<pre>create database example_wiki;</pre>

<li>Grant Permissions</li><br/>
Next you will provide a user for the new database with the permissions that MediaWiki requires. Replace "wikiuser" and "password" with your own specifications. 

<pre>grant index, create, select, insert, update, delete, alter, lock tables on my_wiki.* to 'wikiuser'@'localhost' identified by 'password';</pre>

<li>Finishing Up</li><br/>
Implement changes and quit MySQL.

<pre>FLUSH PRIVILEGES;
exit;</pre>
</ul>


**Visit:** [domain]/mediawiki/index.php.

## Set Up MediaWiki
---
MediaWiki will now be configured through your browser's on-screen instructions.

When you reach the “MySQL settings” section of the setup page, leave the Database Host as localhost; enter in the MySQL database name, username, and password which you setup in the previous steps.

Press continue until you reach the page that says, “Complete!” 

<img src="https://assets.digitalocean.com/articles/mediawiki_centos/img1.png" />

Once the LocalSettings.php file finishes downloading, upload it to **/etc/mediawiki** or whichever directory contains MediaWiki’s “index.php” file on your VPS. 

You can copy the LocalSettings.php file from your computer to the server with SCP (Secure Copy):

	scp /path/to/LocalSettings.php [username]@[IP Address]:/etc/mediawiki

After the file is uploaded, you will be able to access your personal wiki at [domain]/mediawiki!

<div class="author">By Adam LaGreca</div>

MediaWiki is a free open source wiki program that allows users to create their own personal wiki sites. Originally built for Wikpedia, it is now used by thousands of other projects due to its scalability and high customization.  This tutorial goes through how to install and configure MediaWiki on a CentOS 6.4 VPS.

How To Install MediaWiki on Centos 6.4

14.04

### Introduction

MediaWiki is a PHP wiki package, originally intended for use on WikiPedia, which allows anyone to create their own personal wiki site. It is used by a majority of the wikis on the Internet. More information about MediaWiki can be found on its [homepage](https://www.mediawiki.org/wiki/MediaWiki).

This tutorial goes through how to set up MediaWiki on a Ubuntu 14.04 Droplet.

### Prerequisites

* A Ubuntu 14.04 droplet with SSH access. For more information, visit [this tutorial](https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-14-04)
* A LAMP stack, which you can install by following [this tutorial](https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu-14-04)

## Step 1 — Setting Up Your Server

After you have installed the LAMP stack, we will first need to install a few additional PHP 5 modules. All four are optional, but the first two in particular (Intl and GD) are recommended.

The first one we will be installing is the [Intl](http://php.net/manual/en/book.intl.php) extension, for internationalization support:

```
sudo apt-get install php5-intl
```

Secondly, we will install [GD](http://php.net/manual/en/book.image.php) for image thumbnailing:

```
sudo apt-get install php5-gd
```

You can install Tex Live for in-line display of mathematical formulae.

```
sudo apt-get install texlive
```

Finally, you can install XCache for added performance.

```
sudo apt-get install php5-xcache
```

After you've installed the modules you want, restart Apache.

```
sudo service apache2 restart
```

## Step 2 — Downloading MediaWiki

In this section we will download MediaWiki.

MediaWiki is available on the apt-get repository of Ubuntu, but it is out of date. Therefore, it is best to download MediaWiki from source.

```
curl -O http://releases.wikimedia.org/mediawiki/1.24/mediawiki-1.24.1.tar.gz
```

You can double check the latest version on [this page](https://www.mediawiki.org/wiki/Download). Copy the link from **Download MediaWiki** followed by a version number and use that instead of the link above.

After it has finished downloading, extract the package:

```
tar xvzf mediawiki-*.tar.gz
```

Next, we will move the MediaWiki directory to the document root:

```
sudo mv mediawiki-1.24.1/* /var/www/html
```

## Step 3 — Creating a Database

In this section we will set up a MySQL database. This is not strictly required to successfully install MediaWiki, as you can use a SQLite database as well. Despite this, it is definitely a recommended measure.

To create the database, we will first log in to MySQL:

```
mysql -u root -p
```

You will see your terminal prompt change to `mysql>`. 

We can now create the database. You can choose whatever database name you prefer, but the default name in MediaWiki's configuration is `my_wiki`.

```
CREATE DATABASE <^>my_wiki<^>;
```

You should see the output:

```
Query OK, 1 row affected (0.00 sec)
```

Next, we will create a database user for the MediaWiki installation:

```
GRANT INDEX, CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, LOCK TABLES ON <^>my_wiki<^>.* TO '<^>sammy<^>'@'localhost' IDENTIFIED BY '<^>password<^>';
```

Change the first highlighted variable to your chosen database name, the second variable to the username you want to use, and the last to a secure password. You should see the output:

```
Query OK, 0 rows affected (0.00 sec)
```

Next, we need to flush the MySQL privileges.

```
FLUSH PRIVILEGES;
```

The output should be:

```
Query OK, 0 rows affected (0.00 sec)
```

Last, we will need to exit the MySQL shell:

```
exit
```

The output should be:
```
Bye
```

## Step 4 — Setting Up MediaWiki

In this section, we will set up MediaWiki so it is ready to use. Visit the homepage of your Droplet in your browser by pointing your browser to `http://<^>your_server_ip<^>`. On this page, select **set up the wiki**.

On the first page, select a language and click **Continue**. The next page should show your environment and it should say in green: "The environment has been checked. You can install MediaWiki." Click **Continue**.

You will now get to the page with MySQL settings. For the *Database type* select **MySQL (or compatible)**. For the database host, use **localhost**, and for the database name, username, and password, use the values you chose before. The table prefix can be left empty. It will look like this:

![MySQL settings](https://assets.digitalocean.com/articles/mediawiki_ubuntu14/1.png)

After you have completed this step, you will need to complete the tutorial. In the screen after the MySQL settings, the values can be left at their defaults. In the next screen, you will need to fill in the details of your wiki, like its name. You can also create the admin user for the wiki on this page.

In all the other screens, most, if not all, of the settings can be left untouched. If you want a specific setting enabled for your wiki, you might need to change something on one of these screens. Particularly if you have installed XCache before, you will need to check that to enable it.

When you have completed these steps, you should arrive at this page:

![Completed installation](https://assets.digitalocean.com/articles/mediawiki_ubuntu14/2.png)

A file called `LocalSettings.php` should start downloading automatically. To successfully complete the installation, you need to move this file to the server, so make sure to download the file before closing the page.

You should now move it the file to `/var/www/html` on the server. The easiest way to do this is to open the file on your own computer, copy the contents and paste them into the server. To do this, first open the file on the server:

```
nano /var/www/html/LocalSettings.php
```

Now, open the file on your computer in your text editor of choice and copy the contents into your SSH window. After you have saved the file, you can click **enter your wiki** and your wiki should be ready to use.

### Conclusion

You have now installed your own MediaWiki installation which you can use for any purposes you like. You can now customize your installation using the [links](http://www.mediawiki.org/wiki/Manual:System_administration) on the MediaWiki homepage or you can start adding pages.

MediaWiki is a PHP wiki package, originally intended for use on WikiPedia, which allows anyone to create their own personal wiki site. This tutorial goes thorugh how to set up MediaWiki on a Ubuntu 14.04 Droplet.

How To Install MediaWiki on Ubuntu 14.04

senior technical writer

Get alerted when assets are down, slow, or vulnerable to SSL attacks—all free for a month. Learn more