<meta name="description" content="phpBB 3.1.x Installation, updating and conversion informations" />

<title>phpBB &bull; Install</title>

</head>

<a id="top" name="top" accesskey="t"></a>

<div id="page-header">

<div class="headerbar">

<div id="doc-description">

<h1>phpBB 3.1.x Install</h1>

<p>phpBB 3.1.x Installation, updating and conversion informations</p>

<p style="display: none;"><a href="#start_here">Skip</a></p>

</div>

</div>

</div>

<!-- BEGIN DOCUMENT -->

<h1>Install</h1>

<div class="paragraph menu">

<div class="content">

</div>

</div>

<hr />

<a name="quickinstall"></a><h2>1. Quick install</h2>

<div class="paragraph">

<div class="content">

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="require"></a><h2>2. Requirements</h2>

<div class="paragraph">

<div class="content">

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="install"></a><h2>3. New installation</h2>

<div class="paragraph">

<div class="content">

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="update"></a><h2>4. Updating from stable releases of phpBB 3.1.x</h2>

<div class="paragraph">

<div class="content">

<p>If you are currently using a stable release of phpBB, updating to this version is straightforward. You would have downloaded one of four packages and your choice determines what you need to do. <strong>Note</strong>: Before updating, we heavily recommend you do a <em>full backup of your database and existing phpBB files</em>! If you are unsure how to achieve this please ask your hosting provider for advice.</p>

<a name="update_full"></a><h3>4.i. Full package</h3>

<p>First, you should make a copy of your existing <code>config.php</code> file; keep it in a safe place! Next, delete all the existing phpBB files, you may want to leave your <code>files/</code> and <code>images/</code> directories in place. You can leave alternative styles in place too. With this complete, you can upload the new phpBB files (see <a href="#install">New installation</a> for details if necessary). Once complete, copy back your saved <code>config.php</code>, replacing the new one. Another method is to just <strong>replace</strong> the existing files with the files from the full package - though make sure you do <strong>not</strong> overwrite your config.php file.</p>

<p>Once <code>install/database_update.php</code> has completed, you may proceed to the Administration Control Panel and then remove the install directory as advised.</p>

<p>The directory structure has been preserved, enabling you (if you wish) to simply upload the uncompressed contents of the archive to the appropriate location on your server, i.e. simply overwrite the existing files with the new versions. Do not forget that if you have installed any modifications (MODs) these files will overwrite the originals, possibly destroying them in the process. You will need to re-add MODs to any affected file before uploading.</p>

<a name="update_patch"></a><h3>4.iii. Patch file</h3>

<p>If you do get failures, you should look at using the <a href="#update_files">Changed Files</a> package to replace the files which failed to patch. Please note that you will need to manually re-add any MODs to these particular files. Alternatively, if you know how, you can examine the .rej files to determine what failed where and make manual adjustments to the relevant source.</p>

<a name="update_auto"></a><h3>4.iv. Automatic update package</h3>

<p>This update method is the recommended method for updating. This package detects changed files automatically and merges in changes if needed.</p>

<p>To perform the update, either follow the instructions from the <strong>Administration Control Panel-&gt;System</strong> Tab - this should point out that you are running an outdated version and will guide you through the update - or follow the instructions listed below.</p>

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="convert"></a><h2>6. Conversion from phpBB 2.0.x to phpBB 3.1.x</h2>

<div class="paragraph">

<div class="content">

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="postinstall"></a><h2>7. Important (security related) post-Install tasks for all installation methods</h2>

<div class="paragraph">

<div class="content">

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="anti_spam"></a><h2>8. Anti-Spam Measures</h2>

<div class="paragraph">

<div class="content">

<p>Like any online site that allows user input, your board could be subject to unwanted posts; often referred to as <a href="http://en.wikipedia.org/wiki/Forum_spam">forum spam</a>. The vast majority of these attacks will be from automated computer programs known as <a href="http://en.wikipedia.org/wiki/Spambot">spambots</a>. The attacks, generally, are not personal as the spammers are just trying to find accessible targets. phpBB has a number of anti-spam measures built in, including a range of CAPTCHAs. However, administrators are strongly urged to read and follow the advice for <a href="https://www.phpbb.com/support/spam/">Preventing Spam in phpBB</a> as soon as possible after completing the installation of your board.</p>

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<hr />

<a name="disclaimer"></a><h2>9. Copyright and disclaimer</h2>

<div class="paragraph">

<div class="content">

<div class="back2top"><a href="#wrap" class="top">Back to Top</a></div>

</div>

<!-- END DOCUMENT -->

</div></div>

<div>

</div>

</body>