Skip to content

Commit

Permalink
Update README to use docker setup instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
phlax committed Apr 12, 2018
1 parent eccb8c7 commit 0e6ea9e
Showing 1 changed file with 35 additions and 5 deletions.
40 changes: 35 additions & 5 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,16 +30,46 @@ Pootle. Teams can manage their files, permissions, projects, and translate
on-line. Files can be downloaded for offline translation.


Installation
Getting started
---------------

The easiest way to get started is by using the docker demo. You will need docker
installed on your system, and to be running as a user with permissions to manage
docker.

As the docker compose configuration is stored in the pootle directory, you will
need ``git`` installed and ``pip`` for some minimal python dependencies to get
set up.


Virtualenv
----------

You can optionally use a virtualenv to install the python requirements. This
will make it easier to install and run as a user other than ``root``


Demo install
------------

First install the requirements

::

git clone https://github.com/translate/pootle
cd pootle
pip install -r requirements/host.txt

You can now run the demo, using the ``makey`` command runner

::

pip install --process-dependency-links --pre Pootle
makey demo

This will take a few moments to pull the required docker images, and
once up you should be able to browse to your pootle server on
http://localhost:8000

Don't forget to read the `installation guide
<http://docs.translatehouse.org/projects/pootle/en/latest/server/installation.html>`_
for important details.


Copying
Expand Down

0 comments on commit 0e6ea9e

Please sign in to comment.