Running Read the Docs via Supervisord
=====================================
This is the easiest way to start all of the commands you'll need for development
in an environment relatively close to the production evironment. All you need is
``supervisord`` and ``redis-server``. Installation of ``redis-server`` is
outside the scope of this documentation, but once installed, all you need to run
from ``supervisord`` is::
pip install supervisor
cd contrib/
supervisord
This will bring up a web instance for the dashboard, a web instance for
documentation serving, two celery instances, and redis-server.
If you already are running redis-server, this will complain about the port
already being in use, but will still load.
Debugging
---------
To debug, set trace points like normal, with ``pdb``/``ipdb``. Then you can
connect to the process by bringing it to the foreground::
supervisorctl fg main
You'll still see logging to STDERR on the main supervisord process page.