From f70272559d4363e0d499c87378645ef189556206 Mon Sep 17 00:00:00 2001
From: Vanessa Me Tonini <vanessametonini@gmail.com>
Date: Sun, 8 Jul 2018 12:10:18 -0300
Subject: [PATCH] Added Docker instructions to cleanup the Docker setup case it
 has broken

---
 docs/en/getting_started/docker.md | 47 +++++++++++++++++++++++--------
 docs/es/getting_started/docker.md | 45 +++++++++++++++++++++--------
 2 files changed, 70 insertions(+), 22 deletions(-)

diff --git a/docs/en/getting_started/docker.md b/docs/en/getting_started/docker.md
index 7844b0c4e..47dea1fa1 100644
--- a/docs/en/getting_started/docker.md
+++ b/docs/en/getting_started/docker.md
@@ -64,21 +64,21 @@ cp config/database-docker.yml.example config/database.yml
 
 Then you'll have to build the container with:
 ```bash
-sudo docker build -t consul .
+docker build -t consul .
 ```
 
 Create your app database images:
 
 ```bash
-sudo docker-compose up -d database
+docker-compose up -d database
 ```
 
 Once built you can initialize your development DB and populate it with:
 ```
-sudo docker-compose run app rake db:create
-sudo docker-compose run app rake db:migrate
-sudo docker-compose run app rake db:seed
-sudo docker-compose run app rake db:dev_seed
+docker-compose run app rake db:create
+docker-compose run app rake db:migrate
+docker-compose run app rake db:seed
+docker-compose run app rake db:dev_seed
 ```
 
 ### Windows
@@ -91,21 +91,46 @@ Pending to be completed... Contributions Welcome!
 
 Now we can finally run the application with:
 ```bash
-sudo docker-compose up
+docker-compose up
 ```
 
-And you'll be able to acces it at your browser visiting [http://localhost:3000](http://localhost:3000)
+And you'll be able to access it at your browser visiting [http://localhost:3000](http://localhost:3000)
 
 Additionally, if you want to run the rails console just run in another terminal:
 
 ```bash
-sudo docker-compose run app rails console
+docker-compose run app rails console
 ```
 
-To verify the containers are up execute **sudo docker ps .** You should see output similar to this:
-
+To verify the containers are up execute:
+```bash
+docker ps .
+``` 
+You should see output similar to this:
 ![docker ps](https://i.imgur.com/ASvzXrd.png)
 
 ### Windows
 
 Pending to be completed... Contributions Welcome!
+
+## Having trouble?
+Run these commands at **Consul's directory**, to erase all your previous Consul's Docker images and containers. Then restart the Docker [installation process](#installation):
+
+1. Remove all CONSUL images:
+```bash
+docker-compose down --rmi all -v --remove-orphans
+```
+
+2. Remove all CONSUL containers
+```bash
+docker-compose rm -f -s -v
+``` 
+
+3. Verify if there is some container yet:
+```bash
+docker ps -a 
+```
+Case positive, remove each one manually:
+```bash
+docker container rm <container_id>
+```
diff --git a/docs/es/getting_started/docker.md b/docs/es/getting_started/docker.md
index 605ac1c79..8673d3987 100644
--- a/docs/es/getting_started/docker.md
+++ b/docs/es/getting_started/docker.md
@@ -63,20 +63,20 @@ cp config/database-docker.yml.example config/database.yml
 
 Y generamos el contenedor:
 ```bash
-sudo docker build -t consul .
+docker build -t consul .
 ```
 
 Creamos las imágenes de base de datos:
 ```bash
-sudo docker-compose up -d database
+docker-compose up -d database
 ```
 
 Y la inicializamos con:
 ```
-sudo docker-compose run app rake db:create
-sudo docker-compose run app rake db:migrate
-sudo docker-compose run app rake db:seed
-sudo docker-compose run app rake db:dev_seed
+docker-compose run app rake db:create
+docker-compose run app rake db:migrate
+docker-compose run app rake db:seed
+docker-compose run app rake db:dev_seed
 ```
 
 ### Windows
@@ -89,7 +89,7 @@ Pendiente de ser completado... ¡Se agradecen las Contribuciones!
 
 Una vez instalado, puedes lanzar la aplicación con:
 ```bash
-sudo docker-compose up
+docker-compose up
 ```
 
 Y podrás acceder a la aplicación desde tu navegador visitando [http://localhost:3000](http://localhost:3000)
@@ -97,16 +97,39 @@ Y podrás acceder a la aplicación desde tu navegador visitando [http://localhos
 Adicionalmente, si quieres lanzar por ejemplo la consola de rails:
 
 ```bash
-sudo docker-compose run app rails console
+docker-compose run app rails console
 ```
 
 Para verificar que los contenedores estan corriendo usa:
-`sudo docker ps .`
-
+```bash
+docker ps .
+```
 Deberías obtener algo similar a:
-
 ![docker ps](https://i.imgur.com/ASvzXrd.png)
 
 ### Windows
 
 Pendiente de ser completado... ¡Se agradecen las Contribuciones!
+
+
+## ¿Habiendo problemas?
+Ejecute los comandos en el **directorio de CONSUL**, para borrar todas las imágenes y contenedores anteriores del Docker de CONSUL. Luego, reinicie el [proceso de instalación](#instalación) de Docker:
+
+1. Quitar todas las imágenes de CONSUL:
+```bash
+docker-compose down --rmi all -v --remove-orphans
+```
+
+2. Quitar todos los contenedores de CONSUL
+```bash
+docker-compose rm -f -s -v
+``` 
+
+3. Verificar si todavía hay algún contenedor:
+```bash
+docker ps -a 
+```
+Caso positivo, eliminar cada uno de forma manual:
+```bash
+docker container rm <container_id>
+```
\ No newline at end of file