blob: 1b601f802fad21ccc4ffc87dcc214ec122914474 [file] [log] [blame]
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Installing From Packages</title>
<link rel="stylesheet" href="doc.css">
</head>
<body>
<!--#include virtual="_header.html" -->
<div id=content>
<h1>Installing From Packages</h1>
<p class="note">
If you're using Nginx you need
to <a href="build_ngx_pagespeed_from_source">build from source</a>. These
packages are Apache-only.
</p>
<p class="note">
Any releases offered here are pre-apache releases. The incubating project
is working to produce its first release.
</p>
<div id="downloads">
<dl>
<dt>Latest Beta Version</dt>
<dd>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-beta_current_i386.deb">mod_pagespeed 32-bit .deb (Debian/Ubuntu)</a></div>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-beta_current_amd64.deb">mod_pagespeed 64-bit .deb (Debian/Ubuntu)</a></div>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-beta_current_i386.rpm">mod_pagespeed 32-bit .rpm (CentOS/Fedora)</a></div>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-beta_current_x86_64.rpm">mod_pagespeed 64-bit .rpm (CentOS/Fedora)</a></div>
</dd>
<dt>Latest Stable Version</dt>
<dd>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable_current_i386.deb">mod_pagespeed 32-bit .deb (Debian/Ubuntu)</a></div>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable_current_amd64.deb">mod_pagespeed 64-bit .deb (Debian/Ubuntu)</a></div>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable_current_i386.rpm">mod_pagespeed 32-bit .rpm (CentOS/Fedora)</a></div>
<div class=download><a href="https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable_current_x86_64.rpm">mod_pagespeed 64-bit .rpm (CentOS/Fedora)</a></div>
</dd>
</dl>
</div>
<h3>Supported platforms</h3>
<ul>
<li>CentOS/Fedora (32-bit and 64-bit)</li>
<li>Debian/Ubuntu (32-bit and 64-bit)</li>
</ul>
<p>To install the packages, on Debian/Ubuntu, please run the following
command:</p>
<pre class="prettyprint lang-bsh">
sudo dpkg -i mod-pagespeed-*.deb
sudo apt-get -f install
</pre>
<p>For CentOS/Fedora, please execute:</p>
<pre class="prettyprint">
sudo yum install at # if you do not already have 'at' installed
sudo rpm -U mod-pagespeed-*.rpm
</pre>
<p>Installing mod_pagespeed will add the Google repository so your system
will automatically keep mod_pagespeed up to date. If you don't want Google's
repository, do <code>sudo touch /etc/default/mod-pagespeed</code> before
installing the package.</p>
<p>You can also download a number of <a href="https://dl-ssl.google.com/page-speed/mod-pagespeed/mod_pagespeed_examples.tar.gz">system tests</a>. These are the same tests available on <a href="http://www.modpagespeed.com">ModPageSpeed.com</a>.</p>
<h3>What is installed</h3>
<ul>
<li>The mod_pagespeed packages install two versions of the mod_pagespeed code
itself, <code>mod_pagespeed.so</code> for Apache 2.2
and <code>mod_pagespeed_ap24.so</code> for Apache 2.4.</li>
<li>Configuration files: <code>pagespeed.conf</code>, <code>pagespeed_libraries.conf</code>, and (on Debian) <code>pagespeed.load</code>. If you modify one of these configuration files, that file will not be upgraded automatically in the future.</li>
<li>A standalone JavaScript minifier <code>pagespeed_js_minify</code> based on
the one used in mod_pagespeed, that can
both <a href="build_from_source#js-minify">minify JavaScript</a>
and <a href="filter-canonicalize-js#sample">generate metadata for library
canonicalization</a>. </li>
</ul>
<h2>How to upgrade</h2>
<p>To upgrade from a previous version, use the standard <code>yum</code> or
<code>apt-get</code> update commands. For example:</p>
<dl>
<dt>.rpm
<dd><pre>
sudo yum update mod-pagespeed-beta # Or mod-pagespeed-stable
sudo /etc/init.d/httpd restart</pre>
<dt>.deb
<dd><pre>
sudo apt-get update
sudo apt-get upgrade
sudo /etc/init.d/apache2 restart</pre>
</dl>
<h2>How to Change Channels</h2>
<p>To convert from one channel to another, uninstall one and re-install
the other. For example, if you would like to move from stable to beta
channel:</p>
<dl>
<dt>.rpm
<dd><pre>
sudo yum remove mod-pagespeed-stable
sudo yum install mod-pagespeed-beta</pre>
<dt>.deb
<dd><pre>
sudo apt-get remove mod-pagespeed-stable
sudo apt-get install mod-pagespeed-beta</pre>
</dl>
</div>
<!--#include virtual="_footer.html" -->
</body>
</html>