1 To install Shaarli, simply place the files in a directory under your webserver's
2 Document Root (or directly at the document root).
4 Also, please make sure your server meets the [requirements](Server-requirements)
5 and is properly [configured](Server-configuration).
7 Several releases are available:
9 - by downloading full release archives including all dependencies
10 - by downloading Github archives
11 - by cloning the Git repository
15 ## Latest release (recommended)
16 ### Download as an archive
17 Get the latest released version from the [releases](https://github.com/shaarli/Shaarli/releases) page.
19 **Download our *shaarli-full* archive** to include dependencies.
21 The current latest released version is `v0.9.1`
26 $ wget https://github.com/shaarli/Shaarli/releases/download/v0.9.1/shaarli-v0.9.1-full.zip
27 $ unzip shaarli-v0.9.1-full.zip
28 $ mv Shaarli /path/to/shaarli/
31 In most cases, download Shaarli from the [releases](https://github.com/shaarli/Shaarli/releases) page. Cloning using `git` or downloading Github branches as zip files requires additional steps (see below).|
36 $ mkdir -p /path/to/shaarli && cd /path/to/shaarli/
37 $ git clone -b v0.9 https://github.com/shaarli/Shaarli.git .
38 $ composer install --no-dev --prefer-dist
43 The stable version has been experienced by Shaarli users, and will receive security updates.
45 ### Download as an archive
50 $ wget https://github.com/shaarli/Shaarli/archive/stable.zip
52 $ mv Shaarli-stable /path/to/shaarli/
55 As a .tar.gz archive :
58 $ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz
59 $ tar xvf stable.tar.gz
60 $ mv Shaarli-stable /path/to/shaarli/
65 [Composer](https://getcomposer.org/) is required to build a functional Shaarli installation when pulling from git.
68 $ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/
69 # install/update third-party dependencies
70 $ cd /path/to/shaarli/
71 $ composer install --no-dev --prefer-dist
74 ## Development version (mainline)
76 _Use at your own risk!_
78 To get the latest changes from the `master` branch:
81 # clone the repository
82 $ git clone https://github.com/shaarli/Shaarli.git -b master /path/to/shaarli/
83 # install/update third-party dependencies
85 $ composer install --no-dev --prefer-dist
88 ## Finish Installation
90 Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.
92 ![install screenshot](http://i.imgur.com/wuMpDSN.png)
94 Setup your Shaarli installation, and it's ready to use!
98 See [Upgrade and Migration](Upgrade-and-migration)