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

Documentation/bugfix request: mapping paths in Docker

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

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
45/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Estancado
Stack tecnológico
docker, shell
Área
devops, documentation

Línea de trabajo

Comienza con bin/up y bin/stop, luego compara su manejo de rutas con las indicaciones vinculadas sobre el uso compartido de archivos de Docker y las páginas de documentación del toolkit. Reproduce la configuración de directorios separados y verifica que la configuración documentada, el comportamiento de los errores o la validación eviten que los datos desaparezcan después de un reinicio.

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

Descripción

I installed overleaf-toolkit on a brand-new Mac, everything up to date, after installing Docker Desktop, into /opt/bin/overleaf-toolkit. Then when running bin/up I'd get error messages like:

The path /opt/overleaf-toolkit/data/mongo is not shared from the host and is not known to Docker.
You can configure shared paths from Docker -> Preferences... -> Resources -> File Sharing.
See https://docs.docker.com/go/mac-file-sharing/ for more info.

So I did what the messages seemed to be suggesting, and added the following as shared directories in Docker Desktop:

/opt/overleaf-toolkit/data/mongo
/opt/overleaf-toolkit/data/overleaf
/opt/overleaf-toolkit/data/redis

No more error messages, it starts, and I can use Overleaf. The problem is that after ending it with bin/stop and restarting with bin/up all the data is gone! It's a fresh installation asking me to create an admin account.

After much trial and error, I finally figured out that it only works correctly if I add a single shared directory instead:

/opt/overleaf-toolkit

With that, all the data actually persists across restarts. So this is obviously a required configuration, yet:

So it seems like some combination of the following would be helpful?

  • Updating the documentation for installation
  • Clarifying the error message about the correct path that needs to be shared
  • Producing an error if the correct path has not been shared

Hopefully this issue can help other people running into the same problem, with how to solve it.

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.