HomeRental

HomeRental is a dockerized MERN stack app which I developed towards my learning for Distributed systems and dockerization of web apps https://homerental.herokuapp.com/

To launch the entire stack

This launches the services that make up the app so they can be run together in an isolated environment.

docker-compose up -d

Open the app at http://localhost:3000

To down the entire stack

docker-compose down

To re-run the containers that have stopped

docker-compose up --no-recreate

To show running containers

docker-compose ps

More reference on usage of docker-compose cli here

To launch the containers individually

• Create virtual docker network

  docker network create homerental
  

• MongoDB

  docker run -d --name MONGODB_CONTAINER_NAME \
    --network=homerental \
    -p 27017:27017 \
      -e MONGO_INITDB_ROOT_USERNAME=MONGODB_USERNAME \
    -e MONGO_INITDB_ROOT_PASSWORD=MONGODB_PASSWORD \
    mongo
  

• Backend

  docker build -t homerental-backend -f ./homerental-backend/Dockerfile ./homerental-backend/.
  docker run -d --name homerental-backend \
    --network=homerental \
    -p 3500:3500 \
      -e MONGODB_USERNAME=USERNAME_OF_MONGODB \
      -e MONGODB_PASSWORD=PASSWORD_OF_MONGODB \
    -e MONGODB_HOST=HOSTNAME_WHERE_MONGODB_LISTENING \
    -e MONGODB_PORT=PORT_WHERE_MONGODB_LISTENING \
    -e AUTHENTICATING_DATABASE=DB_NAME_WHERE_CREDENTIALS_NEED_TO_AUTHENTICATE \
    -e WAIT_HOSTS=HOST:PORT of MongoDB to make a connection before starting the server
    homerental-backend
  

• Frontend

  docker build -t homerental-frontend -f ./homerental-frontend/Dockerfile ./homerental-frontend/.
  docker run -d --name homerental-frontend \
    --network=homerental \
    -p 3000:3000 \
    -e PROXY_HOST=BACKEND_HOSTNAME \
    -e PROXY_PORT=BACKEND_HOST_PORT \
    homerental-frontend
  

• Launch the website

  firefox http://HOST_NAME:3000
  chrome http://HOST_NAME:3000