From 7f8f8271e49a2834a87012ea838099c8b46cf63f Mon Sep 17 00:00:00 2001 From: Thomas Citharel Date: Sat, 14 Mar 2015 00:22:11 +0100 Subject: redo the whole lot of commits I've deleted while trying Gitlab/Framasoft mirroring --- docs/en/Administrator/download_and_install.html | 261 ++++++++++++++++++++++++ 1 file changed, 261 insertions(+) create mode 100644 docs/en/Administrator/download_and_install.html (limited to 'docs/en/Administrator/download_and_install.html') diff --git a/docs/en/Administrator/download_and_install.html b/docs/en/Administrator/download_and_install.html new file mode 100644 index 00000000..127739c1 --- /dev/null +++ b/docs/en/Administrator/download_and_install.html @@ -0,0 +1,261 @@ + + + + + + + wallabag - Download and install wallabag + + + + + + + + +
+ + + wallabag + + + EN - FR - DE - RU + + +
+ +
+
+ + + + + +
+

Download and install wallabag

+

I don't want to install wallabag

+

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).

+

I want to install wallabag

+

I want to download wallabag the easiest way possible

+

Download the latest wallabag version and unpack it. Copy the files on your web server. Jump off to next section.

+

I want to download wallabag via composer

+

You need to install composer:

+
curl -s http://getcomposer.org/installer | php
+

Next, on your web server, run this command:

+
composer create-project wallabag/wallabag . dev-master
+

All is downloaded into wallabag folder.

+

Permissions

+

Your web server needs a writing access to the assets, cache and db directories. Otherwise, a message will report that the installation is impossible.

+

Installation of wallabag. At last.

+

Access to wallabag from your web browser. If your server is correctly configured, you directly reach the setup screen.

+

Prerequisites

+

The installer will tell you which prerequisites are missing. If there's any, jump off to the corresponding session to know how to deal with that problem.

+

Twig installation

+

wallabag is build with Twig, a template library. You have to download it for wallabag to work.

+
    +
  • One option is to choose the automatic download of the package which will be automatically downloaded and installed.
    • +
  • If this option fails, you can choose the second option which is to manually download the vendor package, unzip it and copy the vendor directory in your wallabag directory
    • +
  • +

    Finally, you can here also use Composer to install Twig by following the commands written on screen :

    +
    curl -s http://getcomposer.org/installer | php
+php composer.phar install
    +
    • +
+

Database connection

+

You have to choose a database system between:

+
    +
  • SQLite: The easiest system of all. No extra configuration needed.
    • +
  • MySQL: A well known database system, which is in most cases more efficient than SQLite
    • +
  • Postgresql: Some people found it better than MySQL.
    • +
+

Note : If you're using MySQL or Postgresql, you have to fill all the fields, otherwise the installation will not work and an error message will tell you what's wrong. You must create the database that you will use for wallabag manually with a tool like PHPMyAdmin or the console.

+

User Account

+

Finally, you need to create an user account. As always, be sure to choose a strong password. +An email field is present but it is not at all required.

+

If you get a green success message, it means wallabag is now installed.

+

Prerequisites

+

List of prerequisites for your web server

+ +

Optionnal:

+ +

Login

+

From your web browser, you reach the login screen: fill your username and your password to connect to your account.

+

Enjoy!

+
+ +
+
+ + + + + + + + + -- cgit v1.2.3