1 #Download and Installation
4 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 [server](Server-requirements) is properly [configured](Server-configuration).[](.html)
6 Several releases are available:
8 --------------------------------------------------------
10 ## Latest release (recommended)
11 ### Download as an archive
12 Get the latest released version from the [releases](https://github.com/shaarli/Shaarli/releases) page.[](.html)
14 **Download our *shaarli-full* archive** to include dependencies.
16 The current latest released version is `v0.8.4`
21 $ wget https://github.com/shaarli/Shaarli/releases/download/v0.8.4/shaarli-v0.8.4-full.zip
22 $ unzip shaarli-v0.8.4-full.zip
23 $ mv Shaarli /path/to/shaarli/
26 | ! |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).|[](.html)
27 |-----|--------------------------|
32 mkdir -p /path/to/shaarli && cd /path/to/shaarli/
33 git clone -b v0.8 https://github.com/shaarli/Shaarli.git .
34 composer install --no-dev
37 --------------------------------------------------------
41 The stable version has been experienced by Shaarli users, and will receive security updates.
43 ### Download as an archive
48 $ wget https://github.com/shaarli/Shaarli/archive/stable.zip
50 $ mv Shaarli-stable /path/to/shaarli/
53 As a .tar.gz archive :
56 $ wget https://github.com/shaarli/Shaarli/archive/stable.tar.gz
57 $ tar xvf stable.tar.gz
58 $ mv Shaarli-stable /path/to/shaarli/
63 [Composer](https://getcomposer.org/) is required to build a functional Shaarli installation when pulling from git.[](.html)
66 $ git clone https://github.com/shaarli/Shaarli.git -b stable /path/to/shaarli/
67 # install/update third-party dependencies
68 $ cd /path/to/shaarli/
69 $ composer install --no-dev
72 --------------------------------------------------------
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
88 --------------------------------------------------------
90 ## Finish Installation
92 Once Shaarli is downloaded and files have been placed at the correct location, open it this location your favorite browser.
94 ![install screenshot](http://i.imgur.com/wuMpDSN.png)[](.html)
96 Setup your Shaarli installation, and it's ready to use!
98 --------------------------------------------------------
102 See [Upgrade and Migration](Upgrade-and-migration)[](.html)