wallabag/docs/fr/Administrateur/telechargement_et_installation.html

257 lines
18 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>wallabag - Télécharger et installer wallabag</title>
<link rel="stylesheet" href="http://doc.wallabag.org/css/bootstrap.min.css">
<link rel="stylesheet" href="http://doc.wallabag.org/css/font-awesome.min.css">
<link rel="stylesheet" href="http://doc.wallabag.org/css/highlight.tomorrow-night.css">
<link rel="stylesheet" href="http://doc.wallabag.org/css/main.css">
</head>
<body>
<header class="navbar navbar-default navbar-fixed-top">
<a class="navbar-brand" href="http://doc.wallabag.org/">
wallabag
<small class="hidden-xs hidden-sm">
Télécharger et installer wallabag
</small>
</a>
<a href="http://doc.wallabag.org/en">EN</a> - <a href="http://doc.wallabag.org/fr">FR</a> - <a href="http://doc.wallabag.org/de">DE</a> - <a href="http://doc.wallabag.org/ru">RU</a>
</header>
<main class="container-fluid">
<div class="row">
<nav id="sidebar" class="col-sm-3 col-lg-2" role="navigation">
<ul class="nav nav-pills nav-stacked">
<h4 class="text-muted">
</h4>
<ul class="nav nav-pills nav-stacked">
<li class="test ">
<a href="http://doc.wallabag.org/fr/index.html">
Pour commencer
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/contribuer_au_projet.html">
Aidez-nous
</a>
</li>
</ul>
<h4 class="text-muted">
Administrateur
</h4>
<ul class="nav nav-pills nav-stacked">
<li class="test active">
<a href="http://doc.wallabag.org/fr/Administrateur/telechargement_et_installation.html">
Téléchargement et installation
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Administrateur/maj_wallabag.html">
Mettre à jour wallabag
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Administrateur/options_cachees.html">
Options cachées
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Administrateur/multi-utilisateurs.html">
wallabag multi-utilisateurs
</a>
</li>
</ul>
<h4 class="text-muted">
Utilisateur
</h4>
<ul class="nav nav-pills nav-stacked">
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/sauvegarder_son_premier_article.html">
Sauvegarder son premier article
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/lire_un_article.html">
Lire un article
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/classer_ses_articles.html">
Classer ses articles
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/configurer_wallabag.html">
Configurer wallabag
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/rechercher.html">
Rechercher
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/convertir_en_epub.html">
Convertir en ePub
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/un_article_est_mal_affiche.html">
Problème d'affichage d'un article
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/flux_rss.html">
Flux RSS
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/importer_exporter.html">
Importer / Exporter
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Utilisateur/framabag.html">
Se créer un compte sur Framabag
</a>
</li>
</ul>
<h4 class="text-muted">
Développeur
</h4>
<ul class="nav nav-pills nav-stacked">
<li class="test ">
<a href="http://doc.wallabag.org/fr/Developpeur/ecrire_fichier_configuration.html">
Écrire un fichier de configuration
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Developpeur/creer_un_nouveau_theme.html">
Créer un nouveau thème
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Developpeur/depot_git.html">
Dépôt git de wallabag
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Developpeur/docker.html">
Docker
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Developpeur/vagrant.html">
Vagrant
</a>
</li>
<li class="test ">
<a href="http://doc.wallabag.org/fr/Developpeur/v2.html">
wallabag v2 / symfony2
</a>
</li>
</ul>
</ul>
</nav>
<section class="col-lg-10">
<h1 id="tlcharger-et-installer-wallabag">Télécharger et installer wallabag</h1>
<h2 id="je-ne-souhaite-pas-installer-wallabag">Je ne souhaite pas installer wallabag</h2>
<p>Puisque vous ne voulez pas, puisque vous ne pouvez pas, nous vous proposons de vous créer un compte gratuit : <a href="../Utilisateur/framabag.html">lisez la documentation complète ici</a>.</p>
<h2 id="je-souhaite-installer-wallabag">Je souhaite installer wallabag</h2>
<h3 id="je-souhaite-tlcharger-wallabag-via-composer">Je souhaite télécharger wallabag via composer</h3>
<p>Vous devez installer composer : </p>
<pre><code>curl -s http://getcomposer.org/installer | php</code></pre>
<p>Ensuite, sur votre serveur web, exécutez cette commande : </p>
<pre><code>composer create-project wallabag/wallabag . dev-master</code></pre>
<p>Tout est téléchargé dans le répertoire courant.</p>
<p>Continuez en lisant la partie ci-dessous, <em>Création de la base de données MySQL</em>.</p>
<h3 id="je-souhaite-tlcharger-wallabag-manuellement">Je souhaite télécharger wallabag manuellement</h3>
<p><a href="http://wllbg.org/latest">Téléchargez la dernière version de wallabag</a> et décompressez-la :</p>
<pre><code>wget http://wllbg.org/latest
unzip latest
mv wallabag-version-number wallabag</code></pre>
<p>Copiez les fichiers sur votre serveur web. Dans le cas d'Ubuntu/Debian, il s'agit de /var/www/html/ :</p>
<pre><code>sudo mv wallabag /var/www/html/</code></pre>
<h4 id="pr-requis-pour-votre-serveur-web">Pré-requis pour votre serveur web</h4>
<ul>
<li><a href="http://php.net/manual/fr/install.php">PHP 5.3.3 ou plus</a></li>
<li><a href="http://php.net/manual/fr/book.sqlite.php">SQLite</a> ou <a href="http://php.net/manual/fr/book.mysql.php">MySQL</a> ou <a href="http://php.net/manual/fr/book.pgsql.php">PostgreSQL</a></li>
<li><a href="http://php.net/fr/xml">XML pour PHP</a></li>
<li><a href="http://php.net/fr/pcre">PCRE</a></li>
<li><a href="http://php.net/manual/fr/book.filter.php">Filtrage des données</a></li>
<li><a href="http://php.net/fr/tidy">Tidy pour PHP</a></li>
<li><a href="http://php.net/fr/curl">cURL</a></li>
<li><a href="http://www.php.net/manual/fr/filesystem.configuration.php#ini.allow-url-fopen">allow_url_fopen</a></li>
<li><a href="http://php.net/manual/fr/book.gettext.php">gettext</a></li>
</ul>
<p>Pour être sûr que votre serveur possède tous les pré-requis, vous pouvez exécuter le fichier <code>wallabag_compatibility_test.php</code> qui se trouve dans le répertoire <code>install</code> de wallabag : dans votre navigateur, accédez à <code>http://votreserveur.com/wallabag/install/wallabag_compatibility_test.php</code> et installez les composants requis. Par exemple pour Tidy sur Ubuntu/Debian :</p>
<pre><code>sudo apt-get install php5-tidy
sudo service apache2 reload</code></pre>
<h4 id="installation-des-dpendances">Installation des dépendances</h4>
<p>Pour pouvoir fonctionner, wallabag a besoin de dépendances. Pour les installer, vous devez utiliser <code>composer</code>. Placez-vous dans votre dossier wallabag (toujours dans le cas d'Ubuntu/Debian : <code>/var/www/html/wallabag/</code>) et exécutez les commandes suivantes :</p>
<pre><code>curl -s http://getcomposer.org/installer | php
php composer.phar install</code></pre>
<p>Si vous ne pouvez pas installer <code>composer</code> (dans le cas d'hébergement mutualisé par exemple), nous vous proposons un fichier <a href="http://wllbg.org/vendor">vendor.zip</a>. Vous pouvez soit le télécharger puis le décompresser dans votre répertoire wallabag, soit laisser le script d'installation le faire pour vous.</p>
<h3 id="cration-de-la-base-de-donnes-mysql">Création de la base de données MySQL</h3>
<p>wallabag peut s'installer sur différents types de bases de données (<code>sqlite</code>, <code>mysql</code> ou <code>postgresql</code>), mais nous vous conseillons d'utiliser MySQL, plus performante. Il est alors nécessaire de créer une nouvelle base (par exemple <code>wallabag</code>), un nouvel utilisateur (par exemple <code>wallabag</code>) et un mot de passe (ici <code>VotreMotdePasse</code>). Vous pouvez pour cela utiliser 'phpMyAdmin', ou exécuter les commandes suivantes :</p>
<pre><code>mysql -p -u root
mysql&gt; CREATE DATABASE wallabag;
mysql&gt; GRANT ALL PRIVILEGES ON `wallabag`.* TO 'wallabag'@'localhost' IDENTIFIED BY 'VotreMotdePasse';
mysql&gt; exit</code></pre>
<h3 id="permissions">Permissions</h3>
<p>Le serveur web doit avoir accès en écriture aux répertoires <code>assets</code>, <code>cache</code> et <code>db</code>. Sans cela, un message vous indiquera que l'installation est impossible :</p>
<pre><code>sudo chown -R www-data:www-data /var/www/html/wallabag</code></pre>
<h3 id="installation-de-wallabag-enfin">Installation de wallabag. Enfin.</h3>
<p>Accédez à wallabag depuis votre navigateur : <code>http://votreserveur.com/wallabag</code>. Si votre serveur est bien configuré, vous arrivez sur l'écran d'installation.</p>
<p>Renseignez le type de votre base de données (<code>sqlite</code>, <code>mysql</code> ou <code>postgresql</code>) et les informations de votre base de données. Dans le cas de la base MySQL créée plus haut, la configuration standard sera :</p>
<pre><code>Database engine: MySQL
Server: localhost
Database: wallabag
Username: wallabag
Password: VotreMotdePasse</code></pre>
<p>Créez enfin votre premier utilisateur et son mot de passe (différents de l'utilisateur de la base de données).</p>
<p>wallabag est maintenant installé.</p>
<h2 id="connexion">Connexion</h2>
<p>Vous arrivez sur l'écran d'identification : saisissez votre identifiant et votre mot de passe et vous voici connecté.</p>
</section>
</div>
</main>
<script src="//code.jquery.com/jquery-1.11.0.min.js"></script>
<script src="//netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></script>
<script src="http://yandex.st/highlightjs/7.5/highlight.min.js"></script>
<script>
$(function() {
$("section>h1").wrap('<div class="page-header" />');
// Syntax highlighting
hljs.initHighlightingOnLoad();
});
</script>
</body>
</html>