]> git.immae.eu Git - github/wallabag/wallabag.git/blame - docs/en/User_documentation/Download_and_install.html
Merge pull request #923 from wallabag/add-html-doc
[github/wallabag/wallabag.git] / docs / en / User_documentation / Download_and_install.html
CommitLineData
a0c57b35
NL
1<!DOCTYPE html>
2<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en"> <![endif]-->
3<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en"> <![endif]-->
4<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en"> <![endif]-->
5<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]-->
6<head>
7 <title>Download and install</title>
c4457fba 8 <meta charset="utf-8">
a0c57b35
NL
9 <meta name="description" content="Documentation for wallabag" />
10 <meta name="author" content="Nicolas Lœuillet">
11 <link rel="icon" href="../../templates/default/themes/daux-blue/img/favicon-blue.png" type="image/x-icon">
12 <!-- Mobile -->
13 <meta name="apple-mobile-web-app-capable" content="yes" />
14 <meta name="viewport" content="width=device-width, initial-scale=1.0">
15
16 <!-- Font -->
c4457fba 17
a0c57b35
NL
18 <!-- CSS -->
19 <link href='../../templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'>
20</head>
21<body>
22 <!-- Docs -->
23 <div class="container-fluid fluid-height wrapper">
24 <div class="navbar navbar-fixed-top hidden-print">
25 <div class="container-fluid">
26 <a class="brand navbar-brand pull-left" href="../../index.html">wallabag</a>
27 <p class="navbar-text pull-right">Generated by <a href="http://daux.io">Daux.io</a></p>
28 </div>
29 </div>
30 <div class="row columns content">
31 <div class="left-column article-tree col-sm-3 hidden-print">
32 <!-- For Mobile -->
33 <div class="responsive-collapse">
34 <button type="button" class="btn btn-sidebar" id="menu-spinner-button">
35 <span class="icon-bar"></span>
36 <span class="icon-bar"></span>
37 <span class="icon-bar"></span>
38 </button>
39 </div>
40 <div id="sub-nav-collapse" class="sub-nav-collapse">
41 <!-- Navigation -->
c4457fba 42 <ul class="nav nav-list"><li><a href="../../en/Getting_started.html">Getting started</a></li><li><a href="../../en/Help_wallabag.html">Help wallabag</a></li><li class="open"><a href="#" class="aj-nav folder">User documentation</a><ul class="nav nav-list"><li class="active"><a href="../../en/User_documentation/Download_and_install.html">Download and install</a></li><li><a href="../../en/User_documentation/Save_your_first_article.html">Save your first article</a></li><li><a href="../../en/User_documentation/Configure_wallabag.html">Configure wallabag</a></li><li><a href="../../en/User_documentation/Hidden_options.html">Hidden options</a></li></ul></li></ul> <div class="well well-sidebar">
a0c57b35
NL
43
44 <!-- Links -->
45 <a href="https://www.wallabag.org/downloads" target="_blank">Download</a><br><a href="https://github.com/wallabag/wallabag" target="_blank">GitHub Repo</a><br><a href="http://support.wallabag.org" target="_blank">Help</a><br><a href="https://github.com/wallabag/documentation/graphs/contributors" target="_blank">Documentation contributors</a><br>
46 <!-- Twitter -->
47 </div>
48 </div>
49 </div>
50 <div class="right-column content-area col-sm-9">
51 <div class="content-page">
52 <article>
53 <div class="page-header sub-header clearfix">
c4457fba 54 <h1>Download and install <a href="https://github.com/wallabag/documentation/blob/master/en/02_User_documentation/02_Download_and_install.md" class="btn">Fix this page</a> </h1>
a0c57b35 55 <span style="float: left; font-size: 10px; color: gray;">
c4457fba 56 Sunday, November 16, 2014 </span>
a0c57b35 57 <span style="float: right; font-size: 10px; color: gray;">
c4457fba 58 9:22 PM </span>
a0c57b35
NL
59 </div>
60
61 <h2>I don't want to install wallabag</h2>
62<p>If you can't or don't want to install Wallabag on your server, we suggest you create a free account on Framabag wich uses our software: read the complete documentation here (TODO write Create a framabag account).</p>
63<h2>I want to install wallabag</h2>
64<p><a href="http://www.wallabag.org/download">Download the latest wallabag version</a> and unpack it. Copy the files on your web server.</p>
65<h2>Prerequisites for your web server</h2>
66<ul>
67<li><a href="http://php.net/manual/en/install.php">PHP 5.3.3 or more</a></li>
68<li><a href="http://php.net/manual/en/book.sqlite.php">SQLite</a> or <a href="http://php.net/manual/fr/book.mysql.php">MySQL</a> or <a href="http://php.net/manual/en/book.pgsql.php">PostgreSQL</a></li>
69<li><a href="http://php.net/xml">XML for PHP</a></li>
70<li><a href="http://php.net/pcre">PCRE</a></li>
71<li><a href="http://php.net/manual/book.filter.php">Data filtering</a></li>
72<li><a href="http://php.net/tidy">Tidy for PHP</a></li>
73<li><a href="http://php.net/curl">cURL</a></li>
74<li><a href="http://www.php.net/manual/en/filesystem.configuration.php#ini.allow-url-fopen">allow_url_fopen</a></li>
75<li><a href="http://php.net/manual/en/book.gettext.php">gettext</a></li>
76</ul>
77<p>To ensure that your server has all the prerequisites, you can run the file <code>wallabag_compatibility_test.php</code> that is located in the <code>install</code> directory of wallabag.</p>
78<h2>Installation of the dependencies</h2>
79<p>In order to work properly, wallabag needs some dependencies. To install them, you have to use <code>composer</code>. In your wallabag folder, run the following commands:</p>
80<pre><code>curl -s http://getcomposer.org/installer | php
81php composer.phar install</code></pre>
82<p>If you can't install <code>composer</code> (In order to work properly, Wallabag needs some dependencies), we provide you a <a href="http://wllbg.org/vendor">vendor.zip</a> file to unpack in your wallabag directory. </p>
83<h2>Permissions</h2>
84<p>Your web server needs a writing access in <code>assets</code>, <code>cache</code> and <code>db</code> directory. Otherwise, a message will report that the installation is impossible.</p>
85<h2>Installation of wallabag. At last.</h2>
86<p>Access to wallabag from your web browser. If your server is correctly configured, you reach the setup screen. </p>
c4457fba 87<p>Fill your database type (<code>sqlite</code>, <code>mysql</code> or <code>postgresql</code>) and finally the information for your user account.</p>
a0c57b35
NL
88<p>wallabag is now installed. </p>
89<h2>Login</h2>
90<p>From your web browser, you reach the login screen : fill your username and your password to connect to your account.</p>
c4457fba
NL
91<p>Enjoy!</p>
92 </article>
a0c57b35
NL
93 </div>
94 </div>
95 </div>
96 </div>
97
98
99
100 <!-- jQuery -->
101 <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
102 <script>
103 if (typeof jQuery == 'undefined')
104 document.write(unescape("%3Cscript src='../../js/jquery-1.11.0.min.js' type='text/javascript'%3E%3C/script%3E"));
105 </script>
106
107 <!-- hightlight.js -->
108 <script src="../../js/highlight.min.js"></script>
109 <script>hljs.initHighlightingOnLoad();</script>
110
111 <!-- JS -->
112
113 <!-- Front end file editor -->
114 <script src="../../js/custom.js"></script>
115 <!--[if lt IE 9]>
116 <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script>
117 <![endif]-->
118
119</body>
120</html>
121