aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/html/Download-and-Installation
diff options
context:
space:
mode:
Diffstat (limited to 'doc/html/Download-and-Installation')
-rw-r--r--doc/html/Download-and-Installation/index.html432
1 files changed, 0 insertions, 432 deletions
diff --git a/doc/html/Download-and-Installation/index.html b/doc/html/Download-and-Installation/index.html
deleted file mode 100644
index 8bc9a5b9..00000000
--- a/doc/html/Download-and-Installation/index.html
+++ /dev/null
@@ -1,432 +0,0 @@
1<!DOCTYPE html>
2<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
3<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
4<head>
5 <meta charset="utf-8">
6 <meta http-equiv="X-UA-Compatible" content="IE=edge">
7 <meta name="viewport" content="width=device-width, initial-scale=1.0">
8
9
10 <link rel="shortcut icon" href="../img/favicon.ico">
11 <title>Download and Installation - Shaarli Documentation</title>
12 <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
13
14 <link rel="stylesheet" href="../css/theme.css" type="text/css" />
15 <link rel="stylesheet" href="../css/theme_extra.css" type="text/css" />
16 <link rel="stylesheet" href="../css/highlight.css">
17 <link href="../github-markdown.css" rel="stylesheet">
18
19 <script>
20 // Current page data
21 var mkdocs_page_name = "Download and Installation";
22 var mkdocs_page_input_path = "Download-and-Installation.md";
23 var mkdocs_page_url = "/Download-and-Installation/";
24 </script>
25
26 <script src="../js/jquery-2.1.1.min.js"></script>
27 <script src="../js/modernizr-2.8.3.min.js"></script>
28 <script type="text/javascript" src="../js/highlight.pack.js"></script>
29
30</head>
31
32<body class="wy-body-for-nav" role="document">
33
34 <div class="wy-grid-for-nav">
35
36
37 <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
38 <div class="wy-side-nav-search">
39 <a href=".." class="icon icon-home"> Shaarli Documentation</a>
40 <div role="search">
41 <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
42 <input type="text" name="q" placeholder="Search docs" />
43 </form>
44</div>
45 </div>
46
47 <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
48 <ul class="current">
49
50
51 <li class="toctree-l1">
52
53 <a class="" href="..">Home</a>
54 </li>
55
56 <li class="toctree-l1">
57
58 <span class="caption-text">Setup</span>
59 <ul class="subnav">
60 <li class=" current">
61
62 <a class="current" href="./">Download and Installation</a>
63 <ul class="subnav">
64
65 <li class="toctree-l3"><a href="#latest-release-recommended">Latest release (recommended)</a></li>
66
67 <ul>
68
69 <li><a class="toctree-l4" href="#download-as-an-archive">Download as an archive</a></li>
70
71 <li><a class="toctree-l4" href="#using-git">Using git</a></li>
72
73 </ul>
74
75
76 <li class="toctree-l3"><a href="#stable-version">Stable version</a></li>
77
78 <ul>
79
80 <li><a class="toctree-l4" href="#download-as-an-archive_1">Download as an archive</a></li>
81
82 <li><a class="toctree-l4" href="#clone-with-git">Clone with Git</a></li>
83
84 </ul>
85
86
87 <li class="toctree-l3"><a href="#development-version-mainline">Development version (mainline)</a></li>
88
89
90 <li class="toctree-l3"><a href="#finish-installation">Finish Installation</a></li>
91
92
93 <li class="toctree-l3"><a href="#updating-shaarli">Updating Shaarli</a></li>
94
95
96 </ul>
97 </li>
98 <li class="">
99
100 <a class="" href="../Upgrade-and-migration/">Upgrade and migration</a>
101 </li>
102 <li class="">
103
104 <a class="" href="../Server-requirements/">Server requirements</a>
105 </li>
106 <li class="">
107
108 <a class="" href="../Server-configuration/">Server configuration</a>
109 </li>
110 <li class="">
111
112 <a class="" href="../Server-security/">Server security</a>
113 </li>
114 <li class="">
115
116 <a class="" href="../Shaarli-configuration/">Shaarli configuration</a>
117 </li>
118 <li class="">
119
120 <a class="" href="../Plugins/">Plugins</a>
121 </li>
122 </ul>
123 </li>
124
125 <li class="toctree-l1">
126
127 <span class="caption-text">Docker</span>
128 <ul class="subnav">
129 <li class="">
130
131 <a class="" href="../docker/docker-101/">Docker 101</a>
132 </li>
133 <li class="">
134
135 <a class="" href="../docker/shaarli-images/">Shaarli images</a>
136 </li>
137 <li class="">
138
139 <a class="" href="../docker/reverse-proxy-configuration/">Reverse proxy configuration</a>
140 </li>
141 <li class="">
142
143 <a class="" href="../docker/resources/">Docker resources</a>
144 </li>
145 </ul>
146 </li>
147
148 <li class="toctree-l1">
149
150 <span class="caption-text">Usage</span>
151 <ul class="subnav">
152 <li class="">
153
154 <a class="" href="../Features/">Features</a>
155 </li>
156 <li class="">
157
158 <a class="" href="../Bookmarklet/">Bookmarklet</a>
159 </li>
160 <li class="">
161
162 <a class="" href="../Browsing-and-searching/">Browsing and searching</a>
163 </li>
164 <li class="">
165
166 <a class="" href="../Firefox-share/">Firefox share</a>
167 </li>
168 <li class="">
169
170 <a class="" href="../RSS-feeds/">RSS feeds</a>
171 </li>
172 <li class="">
173
174 <a class="" href="../REST-API/">REST API</a>
175 </li>
176 </ul>
177 </li>
178
179 <li class="toctree-l1">
180
181 <span class="caption-text">How To</span>
182 <ul class="subnav">
183 <li class="">
184
185 <a class="" href="../Backup,-restore,-import-and-export/">Backup, restore, import and export</a>
186 </li>
187 <li class="">
188
189 <a class="" href="../Various-hacks/">Various hacks</a>
190 </li>
191 </ul>
192 </li>
193
194 <li class="toctree-l1">
195
196 <a class="" href="../Troubleshooting/">Troubleshooting</a>
197 </li>
198
199 <li class="toctree-l1">
200
201 <span class="caption-text">Development</span>
202 <ul class="subnav">
203 <li class="">
204
205 <a class="" href="../Development-guidelines/">Development guidelines</a>
206 </li>
207 <li class="">
208
209 <a class="" href="../Continuous-integration-tools/">Continuous integration tools</a>
210 </li>
211 <li class="">
212
213 <a class="" href="../GnuPG-signature/">GnuPG signature</a>
214 </li>
215 <li class="">
216
217 <a class="" href="../Coding-guidelines/">Coding guidelines</a>
218 </li>
219 <li class="">
220
221 <a class="" href="../Directory-structure/">Directory structure</a>
222 </li>
223 <li class="">
224
225 <a class="" href="../3rd-party-libraries/">3rd party libraries</a>
226 </li>
227 <li class="">
228
229 <a class="" href="../Plugin-System/">Plugin System</a>
230 </li>
231 <li class="">
232
233 <a class="" href="../Release-Shaarli/">Release Shaarli</a>
234 </li>
235 <li class="">
236
237 <a class="" href="../Versioning-and-Branches/">Versioning and Branches</a>
238 </li>
239 <li class="">
240
241 <a class="" href="../Security/">Security</a>
242 </li>
243 <li class="">
244
245 <a class="" href="../Static-analysis/">Static analysis</a>
246 </li>
247 <li class="">
248
249 <a class="" href="../Theming/">Theming</a>
250 </li>
251 <li class="">
252
253 <a class="" href="../Unit-tests/">Unit tests</a>
254 </li>
255 </ul>
256 </li>
257
258 <li class="toctree-l1">
259
260 <span class="caption-text">About</span>
261 <ul class="subnav">
262 <li class="">
263
264 <a class="" href="../FAQ/">FAQ</a>
265 </li>
266 <li class="">
267
268 <a class="" href="../Community-&-Related-software/">Community & Related software</a>
269 </li>
270 </ul>
271 </li>
272
273 </ul>
274 </div>
275 &nbsp;
276 </nav>
277
278 <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
279
280
281 <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
282 <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
283 <a href="..">Shaarli Documentation</a>
284 </nav>
285
286
287 <div class="wy-nav-content">
288 <div class="rst-content">
289 <div role="navigation" aria-label="breadcrumbs navigation">
290 <ul class="wy-breadcrumbs">
291 <li><a href="..">Docs</a> &raquo;</li>
292
293
294
295 <li>Setup &raquo;</li>
296
297
298
299 <li>Download and Installation</li>
300 <li class="wy-breadcrumbs-aside">
301
302 <a href="https://github.com/shaarli/Shaarli/edit/master/docs/Download-and-Installation.md"
303 class="icon icon-github"> Edit on GitHub</a>
304
305 </li>
306 </ul>
307 <hr/>
308</div>
309 <div role="main">
310 <div class="section">
311
312 <p>To install Shaarli, simply place the files in a directory under your webserver's Document Root (or directly at the document root). Make sure your <a href="../Server-requirements">server</a> is properly <a href="../Server-configuration">configured</a>.</p>
313<p>Several releases are available:</p>
314<hr />
315<h2 id="latest-release-recommended">Latest release (recommended)</h2>
316<h3 id="download-as-an-archive">Download as an archive</h3>
317<p>Get the latest released version from the <a href="https://github.com/shaarli/Shaarli/releases">releases</a> page.</p>
318<p><strong>Download our <em>shaarli-full</em> archive</strong> to include dependencies.</p>
319<p>The current latest released version is <code>v0.8.4</code></p>
320<p>Or in command lines:</p>
321<pre><code class="bash">$ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip
322$ unzip shaarli-v0.8.4-full.zip
323$ mv Shaarli /path/to/shaarli/
324</code></pre>
325
326<table>
327<thead>
328<tr>
329<th>!</th>
330<th>In most cases, download Shaarli from the <a href="https://github.com/shaarli/Shaarli/releases">releases</a> page. Cloning using <code>git</code> or downloading Github branches as zip files requires additional steps (see below).</th>
331</tr>
332</thead>
333<tbody></tbody>
334</table>
335<h3 id="using-git">Using git</h3>
336<pre><code>mkdir -p /path/to/shaarli &amp;&amp; cd /path/to/shaarli/
337git clone -b v0.8 https://github.com/shaarli/Shaarli.git .
338composer install --no-dev
339</code></pre>
340
341<hr />
342<h2 id="stable-version">Stable version</h2>
343<p>The stable version has been experienced by Shaarli users, and will receive security updates.</p>
344<h3 id="download-as-an-archive_1">Download as an archive</h3>
345<p>As a .zip archive:</p>
346<pre><code class="bash">$ wget https://github.com/shaarli/Shaarli/archive/stable.zip
347$ unzip stable.zip
348$ mv Shaarli-stable /path/to/shaarli/
349</code></pre>
350
351<p>As a .tar.gz archive :</p>
352<pre><code class="bash">$ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz
353$ tar xvf stable.tar.gz
354$ mv Shaarli-stable /path/to/shaarli/
355</code></pre>
356
357<h3 id="clone-with-git">Clone with Git</h3>
358<p><a href="https://getcomposer.org/">Composer</a> is required to build a functional Shaarli installation when pulling from git.</p>
359<pre><code class="bash">$ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/
360# install/update third-party dependencies
361$ cd /path/to/shaarli/
362$ composer install --no-dev
363</code></pre>
364
365<hr />
366<h2 id="development-version-mainline">Development version (mainline)</h2>
367<p><em>Use at your own risk!</em></p>
368<p>To get the latest changes from the <code>master</code> branch:</p>
369<pre><code class="bash"># clone the repository
370$ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/
371# install/update third-party dependencies
372$ cd /path/to/shaarli
373$ composer install --no-dev
374</code></pre>
375
376<hr />
377<h2 id="finish-installation">Finish Installation</h2>
378<p>Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.</p>
379<p><img alt="install screenshot" src="http://i.imgur.com/wuMpDSN.png" /></p>
380<p>Setup your Shaarli installation, and it's ready to use!</p>
381<hr />
382<h2 id="updating-shaarli">Updating Shaarli</h2>
383<p>See <a href="../Upgrade-and-migration">Upgrade and Migration</a></p>
384
385 </div>
386 </div>
387 <footer>
388
389 <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
390
391 <a href="../Upgrade-and-migration/" class="btn btn-neutral float-right" title="Upgrade and migration">Next <span class="icon icon-circle-arrow-right"></span></a>
392
393
394 <a href=".." class="btn btn-neutral" title="Home"><span class="icon icon-circle-arrow-left"></span> Previous</a>
395
396 </div>
397
398
399 <hr/>
400
401 <div role="contentinfo">
402 <!-- Copyright etc -->
403
404 </div>
405
406 Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
407</footer>
408
409 </div>
410 </div>
411
412 </section>
413
414 </div>
415
416 <div class="rst-versions" role="note" style="cursor: pointer">
417 <span class="rst-current-version" data-toggle="rst-current-version">
418
419 <a href="https://github.com/shaarli/Shaarli" class="fa fa-github" style="float: left; color: #fcfcfc"> GitHub</a>
420
421
422 <span><a href=".." style="color: #fcfcfc;">&laquo; Previous</a></span>
423
424
425 <span style="margin-left: 15px"><a href="../Upgrade-and-migration/" style="color: #fcfcfc">Next &raquo;</a></span>
426
427 </span>
428</div>
429 <script src="../js/theme.js"></script>
430
431</body>
432</html>