Running Loom Master outside of Docker

For now these instructions apply to the 'nopolymorphic' branch, not to the main development or master branches.

Overview

For developers, it can be difficult to debug Loom when running in a Docker container, and with ~10 minutes to build, iterating to test changes is slow.

You can follow the steps below to run the Loom server locally outside of Docker.

Instructions

• Install the MySQL server. Create a database for Loom to use.
• Set the environment variables LOOM_MYSQL_USER, LOOM_MYSQL_HOST, LOOM_MYSQL_PASSWORD, LOOM_MYSQL_DATABASE
• export TEST_DISABLE_TASK_DELAY=true # This runs tasks on the main thread instead of celery
• export LOOM_DEBUG=true # This allows static files to be served, and returns error messages with responses
• cd loom/loomengine/master
• ./manage.py migrate # Create or migrate database tables
• ./manage.py runserver # This should start the server on http://127.0.0.1:8000
• In a separate terminal, connect the client with the command "loom server connect http://127.0.0.1:8000"