From 224e9e0324b6663c2f777a05b731a5268a66be2f Mon Sep 17 00:00:00 2001
From: Andrew Klychkov <aaklychkov@mail.ru>
Date: Wed, 30 Aug 2023 16:45:50 +0200
Subject: [PATCH] [DOCS] tools/docker-compose/README.md: add way to solve
 postgresql issue (#14225)

---
 tools/docker-compose/README.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/tools/docker-compose/README.md b/tools/docker-compose/README.md
index fdca69fe42..6387fb32b9 100644
--- a/tools/docker-compose/README.md
+++ b/tools/docker-compose/README.md
@@ -118,6 +118,23 @@ $ make docker-compose
 
 > For running docker-compose detached mode, start the containers using the following command: `$ make docker-compose COMPOSE_UP_OPTS=-d`
 
+###### Solving database-related issues during initial startup
+
+If you have encountered the infinitely-repeating `Waiting for postgres to be ready to accept connections` message during the execution, try to do the following:
+
+1. Stop and delete AWX-related docker containers.
+2. Delete all associated docker volumes.
+3. Delete all associated docker networks.
+4. Repeat the process from scratch.
+
+If you have **only** AWX-related container entities in your system, you can simply stop and delete everything using the following commands:
+
+```bash
+docker stop $(docker ps -a -q)
+docker system prune -a
+docker volume prune
+docker network prune
+```
 
 ##### _(alternative method)_ Spin up a development environment with customized mesh node cluster
 
@@ -175,7 +192,7 @@ The first time you start the environment, database migrations need to run in ord
 ```bash
 awx_1        | Operations to perform:
 awx_1        |   Synchronize unmigrated apps: solo, api, staticfiles, debug_toolbar, messages, channels, django_extensions, ui, rest_framework, polymorphic
-awx_1        |   Apply all migrations: sso, sessions, sites, kombu_transport_django, social_auth, contenttypes, auth, conf, main
+awx_1        |   Apply all migrations: sso, taggit, sessions, sites, kombu_transport_django, social_auth, contenttypes, auth, conf, main
 awx_1        | Synchronizing apps without migrations:
 awx_1        |   Creating tables...
 awx_1        |     Running deferred SQL...