Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Bugs: Git Bash Path Conversion Causes Docker Mount Failure in Overleaf Toolkit

Abierto
  • ¿Algo no está bien?
#379 5 comentarios 3 reacciones 0 asignados Ver en GitHub

@bfmhno3 ya está trabajando en esto.

Desde el 2/8/2025.

  • #380 de @bfmhno3 — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
35/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
docker, docker-compose, shell
Área
devops, infrastructure

Línea de trabajo

Revisa bin/docker-compose, especialmente set_base_vars y OVERLEAF_IN_CONTAINER_DATA_PATH, y luego reproduce el flujo de trabajo informado con bin/init y bin/up -d desde Git Bash en Windows. Confirma que el montaje de Docker ya no contiene la ruta de instalación de Git inyectada ni demasiados dos puntos, mientras que la ruta del contenedor Linux sigue siendo utilizable.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Bugs: Git Bash Path Conversion Causes Docker Mount Failure in Overleaf Toolkit

Environment

  • OS: Windows 11 Professional 24H2 (Build 26100.4770)
  • Git: 2.50.1.windows.1 (Git Bash kernel: MINGW64_NT-10.0-26100)
  • Docker: 28.3.2 (build 578ccf6)
  • Overleaf Toolkit: Latest commit (4c8ef67d8960fa5eb268072b3c2559b249f97bc8)

Description

When executing Overleaf Toolkit scripts via Git Bash on Windows, Docker encounters a critical mount path error due to Git Bash's automatic POSIX-to-Windows path conversion. The standard initialization workflow completes partially but fails at the container mounting stage with these logs:

amara@Amara MINGW64 /e/Downloads/GitRepo/Github/Docker/overleaf-toolkit (master)
$ ./bin/up -d
Initiating Mongo replica set...
[+] Running 2/2
 ✔ Network overleaf_default  Created                                       0.0s
 ✔ Container mongo           Started                                       0.3s
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017
Waiting for Mongo...
[+] Running 3/3
 ✔ Container redis       Created                                           0.1s
 ✔ Container mongo       Running                                           0.0s
 ✘ Container sharelatex  Error response from dae...                        0.0s
Error response from daemon: mount denied:
the source path "/Users/amara/AppData/Overleaf:D:/Program Files/Git/var/lib/overleaf:rw"
too many colons

Critical Failure Point:
The mount error occurs due to malformed path conversion:

"/Users/amara/AppData/Overleaf:D:/Program Files/Git/var/lib/overleaf:rw"
  • The converter incorrectly injects the Git installation path (D:/Program Files/Git)
  • Creates a hybrid path with multiple colons (:)
  • Docker rejects the invalid path format

Analysis:

  1. Git Bash's path translation modifies /var/lib/overleaf
  2. Docker interprets the converted path as invalid syntax
  3. Volume mapping fails despite successful network and container initialization
  4. The initial MongoDB connection attempts are not errors, but standard waiting routines

Reproduction Steps

# Clone toolkit repository
git clone https://github.com/overleaf/toolkit.git
cd toolkit

# Initialize configuration
./bin/init

# Launch services (fails)
./bin/up -d

Proposed Solution

Modify paths in bin/docker-compose to bypass translation:

function set_base_vars() {
  ...
- OVERLEAF_IN_CONTAINER_DATA_PATH=/var/lib/overleaf
+ OVERLEAF_IN_CONTAINER_DATA_PATH=//var/lib/overleaf
  if [[ "$IMAGE_VERSION_MAJOR" -lt 5 ]]; then
-   OVERLEAF_IN_CONTAINER_DATA_PATH=/var/lib/sharelatex
+   OVERLEAF_IN_CONTAINER_DATA_PATH=//var/lib/sharelatex
  fi
  ...
}

Rationale:

  • Double-slash prefix //var/... works in Linux containers
  • Prevents Git Bash path conversion
  • Maintains cross-OS compatibility
Lenguaje dominante
Shell
Estrellas
1.3k
Forks
314
Merge medio
9 d 7 h
PR fusionados (30 d)
1

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de overleaf/toolkit

Todos los issues de overleaf/toolkit

Issues similares

Más issues de Shell/Bash

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.