How to deploy Source Code on local machines

Docker compose tutorial

If the user wants to deploy on local machines, then follow the following steps.

  1. Create a directory

  2. Download frontend, backend, Caddyfile, and docker-compose.yml source codes to the directory

  3. Download Cas-offinder from https://github.com/pnucolab/variant-aware-cas-offinder/raw/refs/heads/main/backend/cas-offinder and make it executable:

chmod +x cas-offinder
  1. Build and start all services:

docker compose build
  1. After building, run the following command to start the services

docker compose up -d

Check running container:

docker compose ps

To run a command inside a running container (backend).

docker compose exec backend sh

This is useful when you need to:

  • Manually inspect or debug the backend container.

  • Run Python scripts, check logs, or test API endpoints.

  • Install additional dependencies inside the container temporarily.

To view logs (optional):

docker compose logs backend

To stop the containers, run:

docker compose down

To stop the backend, run:

docker compose down backend