Commands — notes_chat_app Command Cheatsheet¶
Docker Compose¶
# ─── Start ────────────────────────────────────────────────────────────
docker compose up --build # build and start all services
docker compose up -d # start in the background (detached)
docker compose up -d --build # rebuild + background
# ─── Stop ─────────────────────────────────────────────────────────────
docker compose down # stop (volumes are kept)
docker compose down -v # stop + remove volumes (reset the DB)
docker compose down --rmi all # stop + remove images
# ─── Status ───────────────────────────────────────────────────────────
docker compose ps # status of all services
docker compose ps web # status of web only
# ─── Logs ─────────────────────────────────────────────────────────────
docker compose logs web # all web logs
docker compose logs -f web # follow in real time
docker compose logs --tail=50 web # last 50 lines
# ─── Shell ────────────────────────────────────────────────────────────
docker compose exec web bash # bash in web
docker compose exec web python manage.py shell # Django shell
docker compose exec db psql -U notes_user notes_db # PostgreSQL shell
# ─── Restart ──────────────────────────────────────────────────────────
docker compose restart web # restart web only
docker compose build --no-cache web # rebuild without cache
Django manage.py¶
In Docker, always run via
docker compose run --rm webordocker compose exec web
# ─── Migrations ───────────────────────────────────────────────────────
docker compose run --rm web python manage.py makemigrations
docker compose run --rm web python manage.py migrate
docker compose run --rm web python manage.py migrate --fake # mark as applied
docker compose run --rm web python manage.py showmigrations
docker compose run --rm web python manage.py sqlmigrate notes_app 0001
# ─── Static files ─────────────────────────────────────────────────────
docker compose run --rm web python manage.py collectstatic --noinput
# ─── Demo data ────────────────────────────────────────────────────────
docker compose run --rm web python manage.py seed_demo_data # seed
docker compose run --rm web python manage.py seed_demo_data --reset # clear + seed
docker compose run --rm web python manage.py seed_demo_data --force # for DEBUG=False
# ─── Users ────────────────────────────────────────────────────────────
docker compose run --rm web python manage.py createsuperuser
# ─── Checks ───────────────────────────────────────────────────────────
docker compose run --rm web python manage.py check
docker compose run --rm web python manage.py check --deploy # production audit
# ─── Shell ────────────────────────────────────────────────────────────
docker compose exec web python manage.py shell
docker compose exec web python manage.py shell_plus # if django-extensions is installed
docker compose exec web python manage.py dbshell # SQL shell
Tests¶
# ─── Unit + Integration + Consumer tests ─────────────────────────────
docker compose run --rm web python manage.py test \
notes_app.tests.test_models \
notes_app.tests.test_services \
notes_app.tests.test_forms \
notes_app.tests.test_views \
notes_app.tests.test_consumers -v 2
# ─── A single module ──────────────────────────────────────────────────
docker compose run --rm web python manage.py test notes_app.tests.test_models -v 2
docker compose run --rm web python manage.py test notes_app.tests.test_services -v 2
docker compose run --rm web python manage.py test notes_app.tests.test_consumers -v 2
# ─── Selenium E2E (via exec!) ─────────────────────────────────────────
docker compose up -d # the stack must be running
docker compose exec web python manage.py test notes_app.tests.test_selenium -v 2
# ─── Coverage ─────────────────────────────────────────────────────────
docker compose run --rm web bash -c \
"coverage run manage.py test notes_app.tests.test_models \
notes_app.tests.test_services \
notes_app.tests.test_forms \
notes_app.tests.test_views \
notes_app.tests.test_consumers \
&& coverage report --show-missing"
Uvicorn (locally, without Docker)¶
# Start the ASGI server (if PostgreSQL and Redis are already running):
uvicorn notes_project.asgi:application --reload --port 8001
# With all parameters:
uvicorn notes_project.asgi:application \
--host 0.0.0.0 \
--port 8001 \
--reload \
--log-level debug
Ngrok¶
# Tunnel to nginx (via Docker — no separate step needed):
# Started automatically by docker compose up
# Locally (without Docker):
ngrok http --url=your-domain.ngrok-free.app 80
# Dashboard:
open http://localhost:4040