Skip to content

Latest commit

 

History

History
79 lines (59 loc) · 2.67 KB

Running_the_App_in_dev.md

File metadata and controls

79 lines (59 loc) · 2.67 KB

Running the app with docker for development

⚠ Note for Windows users

This documentation is written for Linux-based systems. If you are using Windows, please be aware of some subtle changes:

  1. Do not use the built-in commad-line, but the PowerShell. Some syntax will not work on the command-line.
  2. There is no sudo. Most of the commands will work without the sudo. If you encounter permission errors, please run your PowerShell as administrator.

Install Prerequisites

Install docker and docker-compose. Install git.

Setup OwnRecipes

First clone the repos:

git clone https://github.com/ownrecipes/OwnRecipes.git
cd OwnRecipes

git clone https://github.com/ownrecipes/ownrecipes-api.git
git clone https://github.com/ownrecipes/ownrecipes-web.git

Then run it:

sudo docker compose --profile all build
sudo docker compose --profile all up

Click here if docker compose throws an error.

All container, db, api and web, should start successfully. Check the terminal output for any error. If you encounter any issue, please read the Troubleshooting guide.

First Time Setup

To create a super user:

sudo docker compose run --rm --entrypoint 'python manage.py createsuperuser' api

Follow the prompts given to create your user. You can do this as many times as you like.

If you want to add some test data you can load a few recipes and some news data. This data isn't really needed unless you just wanna see how the app looks and if its working.

sudo docker compose run --rm --entrypoint 'sh' api
./manage.py loaddata course_data.json
./manage.py loaddata cuisine_data.json
./manage.py loaddata season_data.json
./manage.py loaddata tag_data.json
./manage.py loaddata news_data.json
./manage.py loaddata recipe_data.json
./manage.py loaddata ing_data.json

Finish up

The set up is complete and everything should be up and running.

You can visit the Admin Site, to create some more users, customize the news, or manage some lists.

Or you can straight away log in to the OwnRecipes web app. By default, the url will be http://localhost:8080.

OwnRecipes will shut down with your system. You can simply launch OwnRecipes by running:

cd OwnRecipes
sudo docker compose --profile all up

If you encounter any issue, please read the Troubleshooting guide.

Updating/Upgrading

See Updating the App