Editing Manual/Upgrading (section)

=== Using a tarball package === <!--T:40-->

<!--T:41-->
You can put the new files into place using FTP or the command line. Use the command line, if you have access to it! Using the command line will be much faster than having to upload each single one of the thousands of files via FTP.
</translate>

{{Note|1=<translate><!--T:42--> You should put the decompressed tarball in a new and empty folder on your server. If you instead extract the new version directly on top of your old version, rather than in a new directory, you should follow the instructions described in [[<tvar name=1>#Back up existing files and the database</tvar>|Back up existing files and the database]]: otherwise, if you've made any customizations you may erase them in a way that leaves you with no reference to re-apply them from.</translate> <translate><!--T:43--> Extracting a tarball over top of your live copy of MediaWiki can also leave behind files from the old version of MediaWiki which may interfere with the upgraded code.</translate> <translate><!--T:612--> It's recommended that you unpack the new files into a new directory, and then apply customizations to the new directory (restoring <tvar name=1><code>LocalSettings.php</code></tvar>, images folder, extensions, and other customizations like custom skins).</translate>}}

<translate>
==== FTP or graphical ==== <!--T:44-->

<!--T:45-->
If you cannot access the command line on your server, download the MediaWiki tarball to your local computer and use <tvar name=7zip>[http://www.7-zip.org/download.html 7zip]</tvar> to extract the tarball on your local PC.

<!--T:46-->
After you extracted the files locally, use your favorite FTP client software to upload directories and files to the server.

==== cPanel File Manager ==== <!--T:564-->
</translate>
<translate><!--T:565--> cPanel is a popular interface provided by many web hosts.</translate>
<translate><!--T:566--> This method is efficient because the files are uncompressed on the server itself.</translate>

* <translate><!--T:567--> Navigate to the directory that holds your wiki folder.</translate>
* <translate><!--T:568--> Upload the <tvar name=1>mediawiki-1.xx.x.tar.gz</tvar> file.</translate> <translate><!--T:569--> You may need to hit "Reload" to see it.</translate>
* <translate><!--T:570--> Extract the <tvar name=1>mediawiki-1.xx.x.tar.gz</tvar> file.</translate> <translate><!--T:571--> Reload again.</translate>
* <translate><!--T:572--> Confirm that the <tvar name=1>mediawiki-1.xx.x</tvar> folder is present.</translate>
* <translate><!--T:573--> Delete the tar.gz file.</translate>
* <translate><!--T:574--> Copy all necessary skins, extensions, image folders, customizations, and the <tvar name=1><code>LocalSettings.php</code></tvar> into the new folder.</translate> <translate><!--T:575--> (See below.)</translate>
* <translate><!--T:576--> When you are ready to run <tvar name=1>update.php</tvar>, rename your old wiki folder and your new wiki folder.</translate> <translate><!--T:577--> (e.g. "w" becomes "w1.34" and then "mediawiki1.35.0" becomes "w".)</translate> <translate><!--T:578--> This step is easily reversible if you run into problems.</translate>

<translate>
==== Command line ==== <!--T:47-->
</translate>
<translate><!--T:48--> You may need to run the command as <code>sudo</code> if you don't have full write permissions to the wiki install directories under your current user.</translate>
<translate><!--T:224--> When untarring a tarball package normally a new directory for the new wiki version will be created and you will have to copy the old configuration files and images directory from your old installation directory:</translate>

<code class="mw-code mw-highlight plainlinks" style="display:block"><!--
--> /path/to/your/new/installation/  
wget https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz
tar xvzf mediawiki-.tar.gz
rm mediawiki-.tar.gz
</code>

<translate>
<!--T:49-->
(Open)Solaris users should use <kbd>gtar</kbd>, or:
</translate>

 $ gzip -dc mediawiki-.tar.gz | tar xf -

<translate>