diff options
author | Paulino Michelazzo <paulino@michelazzo.com.br> | 2016-10-18 22:48:23 +0200 |
---|---|---|
committer | Paulino Michelazzo <paulino@michelazzo.com.br> | 2016-10-18 22:48:23 +0200 |
commit | 99731f0bb1f6fd2815eeb9af504ce86df927657b (patch) | |
tree | b080efc608d2bbd52b77a4a0067402007f50c5a8 /docs/en/user/installation.rst | |
parent | 3a3c6b866b52721431bed22426d9abfcd0d2dfe0 (diff) | |
parent | 7180aaed45dce62e40620a9e4b202526ebd6a3bb (diff) | |
download | wallabag-99731f0bb1f6fd2815eeb9af504ce86df927657b.tar.gz wallabag-99731f0bb1f6fd2815eeb9af504ce86df927657b.tar.zst wallabag-99731f0bb1f6fd2815eeb9af504ce86df927657b.zip |
Merge remote-tracking branch 'wallabag/master'
Diffstat (limited to 'docs/en/user/installation.rst')
-rw-r--r-- | docs/en/user/installation.rst | 52 |
1 files changed, 27 insertions, 25 deletions
diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 763d7c66..45e14616 100644 --- a/docs/en/user/installation.rst +++ b/docs/en/user/installation.rst | |||
@@ -6,7 +6,21 @@ Requirements | |||
6 | 6 | ||
7 | wallabag is compatible with PHP >= 5.5, including PHP 7. | 7 | wallabag is compatible with PHP >= 5.5, including PHP 7. |
8 | 8 | ||
9 | You'll need the following extensions for wallabag to work. Some of these may already activated in your version of PHP, so you may not have to install all corresponding packages. | 9 | .. note:: |
10 | |||
11 | To install wallabag easily, we provide a ``Makefile``, so you need to have the ``make`` tool. | ||
12 | |||
13 | wallabag uses a large number of PHP libraries in order to function. These libraries must be installed with a tool called Composer. You need to install it if you have not already done so and be sure to use the 1.2 version (if you already have Composer, run a ``composer selfupdate``). | ||
14 | |||
15 | Install Composer: | ||
16 | |||
17 | :: | ||
18 | |||
19 | curl -s http://getcomposer.org/installer | php | ||
20 | |||
21 | You can find specific instructions `here <https://getcomposer.org/doc/00-intro.md>`__. | ||
22 | |||
23 | You'll also need the following extensions for wallabag to work. Some of these may already activated in your version of PHP, so you may not have to install all corresponding packages. | ||
10 | 24 | ||
11 | - php-session | 25 | - php-session |
12 | - php-ctype | 26 | - php-ctype |
@@ -22,6 +36,7 @@ You'll need the following extensions for wallabag to work. Some of these may alr | |||
22 | - php-curl | 36 | - php-curl |
23 | - php-gettext | 37 | - php-gettext |
24 | - php-tokenizer | 38 | - php-tokenizer |
39 | - php-bcmath | ||
25 | 40 | ||
26 | wallabag uses PDO to connect to the database, so you'll need one of the following: | 41 | wallabag uses PDO to connect to the database, so you'll need one of the following: |
27 | 42 | ||
@@ -37,31 +52,18 @@ Installation | |||
37 | On a dedicated web server (recommended way) | 52 | On a dedicated web server (recommended way) |
38 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 53 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
39 | 54 | ||
40 | wallabag uses a large number of libraries in order to function. These libraries must be installed with a tool called Composer. You need to install it if you have not already done so and be sure to use the 1.2 version (if you already have Composer, run a ``composer selfupdate``). | ||
41 | |||
42 | Install Composer: | ||
43 | |||
44 | :: | ||
45 | |||
46 | curl -s http://getcomposer.org/installer | php | ||
47 | |||
48 | You can find specific instructions `here <https://getcomposer.org/doc/00-intro.md>`__: | ||
49 | |||
50 | To install wallabag itself, you must run the following commands: | 55 | To install wallabag itself, you must run the following commands: |
51 | 56 | ||
52 | :: | 57 | :: |
53 | 58 | ||
54 | git clone https://github.com/wallabag/wallabag.git | 59 | git clone https://github.com/wallabag/wallabag.git |
55 | cd wallabag | 60 | cd wallabag && make install |
56 | git checkout 2.0.8 | ||
57 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | ||
58 | php bin/console wallabag:install --env=prod | ||
59 | 61 | ||
60 | To start PHP's build-in server and test if everything did install correctly, you can do: | 62 | To start PHP's build-in server and test if everything did install correctly, you can do: |
61 | 63 | ||
62 | :: | 64 | :: |
63 | 65 | ||
64 | php bin/console server:run --env=prod | 66 | make run |
65 | 67 | ||
66 | And access wallabag at http://yourserverip:8000 | 68 | And access wallabag at http://yourserverip:8000 |
67 | 69 | ||
@@ -85,18 +87,18 @@ Execute this command to download and extract the latest package: | |||
85 | 87 | ||
86 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package | 88 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package |
87 | 89 | ||
88 | (md5 hash of the package: ``4f84c725d1d6e3345eae0a406115e5ff``) | 90 | You will find the `md5 hash of the latest package on our website <https://www.wallabag.org/pages/download-wallabag.html>`_. |
89 | 91 | ||
90 | Now, read the following documentation to create your virtual host, then access your wallabag. | 92 | Now, read the following documentation to create your virtual host, then access your wallabag. |
91 | If you changed the database configuration to use MySQL or PostgreSQL, you need to create a user via this command ``php bin/console wallabag:install --env=prod``. | 93 | If you changed the database configuration to use MySQL or PostgreSQL, you need to create a user via this command ``php bin/console wallabag:install --env=prod``. |
92 | 94 | ||
93 | Installation with Docker | 95 | Installation with Docker |
94 | ------------------------ | 96 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
95 | 97 | ||
96 | We provide you a Docker image to install wallabag easily. Have a look to our repository on `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ to have more information. | 98 | We provide you a Docker image to install wallabag easily. Have a look at our repository on `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ for more information. |
97 | 99 | ||
98 | Command to launch container | 100 | Command to launch container |
99 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 101 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
100 | 102 | ||
101 | .. code-block:: bash | 103 | .. code-block:: bash |
102 | 104 | ||
@@ -192,12 +194,12 @@ After reloading or restarting nginx, you should now be able to access wallabag a | |||
192 | 194 | ||
193 | .. tip:: | 195 | .. tip:: |
194 | 196 | ||
195 | When you want to import large file into wallabag, you need to add this line in your nginx configuration ``client_max_body_size XM; # allows file uploads up to X megabytes``. | 197 | When you want to import large files into wallabag, you need to add this line in your nginx configuration ``client_max_body_size XM; # allows file uploads up to X megabytes``. |
196 | 198 | ||
197 | Configuration on lighttpd | 199 | Configuration on lighttpd |
198 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | 200 | ~~~~~~~~~~~~~~~~~~~~~~~~~ |
199 | 201 | ||
200 | Assuming you install wallabag in the /var/www/wallabag folder, here's the recipe for wallabag (edit your ``lighttpd.conf`` file and paste this configuration into it): | 202 | Assuming you install wallabag in the ``/var/www/wallabag`` folder, here's the recipe for wallabag (edit your ``lighttpd.conf`` file and paste this configuration into it): |
201 | 203 | ||
202 | :: | 204 | :: |
203 | 205 | ||
@@ -238,16 +240,16 @@ Rights access to the folders of the project | |||
238 | Test environment | 240 | Test environment |
239 | ~~~~~~~~~~~~~~~~ | 241 | ~~~~~~~~~~~~~~~~ |
240 | 242 | ||
241 | When we just want to test wallabag, we just run the command ``php bin/console server:run --env=prod`` to start our wallabag instance and everything will go smoothly because the user who started the project can access to the current folder naturally, without any problem. | 243 | When we just want to test wallabag, we just run the command ``make run`` to start our wallabag instance and everything will go smoothly because the user who started the project can access to the current folder naturally, without any problem. |
242 | 244 | ||
243 | Production environment | 245 | Production environment |
244 | ~~~~~~~~~~~~~~~~~~~~~~ | 246 | ~~~~~~~~~~~~~~~~~~~~~~ |
245 | 247 | ||
246 | As soon as we use Apache or Nginx to access to our wallabag instance, and not from the command ``php bin/console server:run --env=prod`` to start it, we should take care to grant the good rights on the good folders to keep safe all the folders of the project. | 248 | As soon as we use Apache or Nginx to access to our wallabag instance, and not from the command ``make run`` to start it, we should take care to grant the good rights on the good folders to keep safe all the folders of the project. |
247 | 249 | ||
248 | To do so, the folder name, known as ``DocumentRoot`` (for apache) or ``root`` (for Nginx), has to be absolutely accessible by the Apache/Nginx user. Its name is generally ``www-data``, ``apache`` or ``nobody`` (depending on linux system used). | 250 | To do so, the folder name, known as ``DocumentRoot`` (for apache) or ``root`` (for Nginx), has to be absolutely accessible by the Apache/Nginx user. Its name is generally ``www-data``, ``apache`` or ``nobody`` (depending on linux system used). |
249 | 251 | ||
250 | So the folder ``/var/www/wallabag/web`` has to be accessible by this last one. But this could be not enough if we just care about this folder, because we could meet a blank page or get an error 500 when trying to access to the homepage of the project. | 252 | So the folder ``/var/www/wallabag/web`` has to be accessible by this last one. But this may not be enough if we just care about this folder, because we could meet a blank page or get an error 500 when trying to access to the homepage of the project. |
251 | 253 | ||
252 | This is due to the fact that we will need to grant the same rights access on the folder ``/var/www/wallabag/var`` like those we gave on the folder ``/var/www/wallabag/web``. Thus, we fix this problem with the following command: | 254 | This is due to the fact that we will need to grant the same rights access on the folder ``/var/www/wallabag/var`` like those we gave on the folder ``/var/www/wallabag/web``. Thus, we fix this problem with the following command: |
253 | 255 | ||