2016-02-17 13:39:30 +00:00
|
|
|
Run wallabag in docker-compose
|
2016-01-09 18:02:24 +00:00
|
|
|
==============================
|
|
|
|
|
|
|
|
|
|
In order to run your own development instance of wallabag, you may
|
|
|
|
|
want to use the pre-configured docker compose files.
|
|
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
Make sure to have `Docker
|
|
|
|
|
<https://docs.docker.com/installation/ubuntulinux/>`__ and `Docker
|
|
|
|
|
Compose <https://docs.docker.com/compose/install/>`__ availables on
|
|
|
|
|
your system and up to date.
|
|
|
|
|
|
|
|
|
|
Switch DBMS
|
|
|
|
|
-----------
|
|
|
|
|
|
2016-02-20 07:39:08 +00:00
|
|
|
By default, wallabag will start with a SQLite database.
|
2016-02-17 13:39:30 +00:00
|
|
|
Since wallabag provides support for Postgresql and MySQL, docker
|
2016-01-09 18:02:24 +00:00
|
|
|
containers are also available for these ones.
|
|
|
|
|
|
2016-02-20 07:39:08 +00:00
|
|
|
In ``docker-compose.yml``, for the chosen DBMS uncomment:
|
2016-01-09 18:02:24 +00:00
|
|
|
|
|
|
|
|
- the container definition (``postgres`` or ``mariadb`` root level
|
|
|
|
|
block)
|
|
|
|
|
- the container link in the ``php`` container
|
|
|
|
|
- the container env file in the ``php`` container
|
|
|
|
|
|
|
|
|
|
In order to keep running Symfony commands on your host (such as
|
2016-02-20 07:39:08 +00:00
|
|
|
``wallabag:install``), you also should:
|
2016-01-09 18:02:24 +00:00
|
|
|
|
|
|
|
|
- source the proper env files on your command line, so variables
|
|
|
|
|
like ``SYMFONY__ENV__DATABASE_HOST`` will exist.
|
|
|
|
|
- create a ``127.0.0.1 rdbms`` on your system ``hosts`` file
|
|
|
|
|
|
2016-02-17 13:39:30 +00:00
|
|
|
Run wallabag
|
2016-01-09 18:02:24 +00:00
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
#. Fork and clone the project
|
|
|
|
|
#. Edit ``app/config/parameters.yml`` to replace ``database_*``
|
|
|
|
|
properties with commented ones (with values prefixed by ``env.``)
|
|
|
|
|
#. ``composer install`` the project dependencies
|
|
|
|
|
#. ``php app/console wallabag:install`` to create the schema
|
|
|
|
|
#. ``docker-compose up`` to run the containers
|
|
|
|
|
#. Finally, browse to http://localhost:8080/ to find your freshly
|
|
|
|
|
installed wallabag.
|
|
|
|
|
|
|
|
|
|
At various step, you'll probably run into UNIX permission problems,
|
|
|
|
|
bad paths in generated cache, etc…
|
|
|
|
|
Operations like removing cache files or changing files owners might
|
|
|
|
|
be frequently required, so don't be afraid !
|
