Running the app

In development mode

Begin by cloning the Github repo and installing the dependencies:

git clone [email protected]:epimorphics/lr-landing.git &&
cd lr-landing &&
bundle install

Trouble shooting bundle install

If bundle install does not work add a .bundle directory and create a config file. So you now have .bundle/config. Add the following line to the config file. BUNDLE_RUBYGEMS__PKG__GITHUB__COM: "your-username:your-personal-access-token" Then run bundle install again and eveything should work.

Start the app locally for development:

rails server

If you want to be able to test Qonsole locally, you will need to run the app with the API_SERVICE_URL environment variable set to the URL of the Data API:

API_SERVICE_URL=http://localhost:8888 rails server

Visit http://localhost:3000 to view the local instance.

In production mode

Unlike other HMLR applications, the Landing application does not run run from a sub-directory.

As such Production and Development modes run at the same path.

If running more than one application locally you need to ensure that each is listening on a separate port. In the case of running local docker images, the required configuration is captured in the application's Makefile and an image can be run by using:

make image run

or, if the image is already built, simply

make run

You can start a production mode rails server locally using the following command:

rails server -e production

N.B Ommitting the -e flag will default to development mode.

To test the running application visit http://localhost:3000 in your browser.

For more information on how to running a proxy to mimic production and run multple services together see simple-web-proxy

With the proxy and Docker container running you can access the application as localhost:8080 (note the lack of trailing path).