docker invalid characters for local volume name

A few days ago, I installed docker on my new laptop. I’ve used docker for a while and know the basics pretty well. Yet, for some reason I keep bumping into the same problem and I hope someone here can help me.

After installing the Docker Toolbox on my Windows 10 Home laptop, I tried to run some images that I’ve created using a docker-compose.yml. Since my user directory on windows has my exact name in it (C:/Users/Nick van der Meij) and that name contains spaces, I added an extra shared folder from C:/code to /mnt/code on the Docker Host (this works). I’ve used this guide to do so

  • Docker Overlay network -service name issue between two nodes
  • Where is the base docker image specified in Play Framework?
  • dokku - Run Rails 4 app from Subfolder
  • dumb-init No such file or directory
  • How to install a minimal cuda driver file into Alpine linux
  • Dockerfile - Mount host directory - copy a tar fie and run it - Error
  • However, when I try to run my docker-compose.yml (included below), I get the following error:

    ERROR: for php  Cannot create container for service php: create \mnt\code\basic_php\api: "\\mnt\\code\\basic_php\\api" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed
    [31mERROR[0m: Encountered errors while bringing up the project.

    As far as I see it, everything seems to be correct according to the official docker docs about volumes. I’ve spend many hours trying to fix this and tried out multiple “formats” for the volumes tag, yet without any success.

    Does anyone know what the problem might be?

    Thanks in Advance!


    version: '2'
            image: mysql:5.7
                - 3306
                - /var/lib/mysql
            restart: always
                MYSQL_ROOT_PASSWORD: password
                MYSQL_USER: user
                MYSQL_PASSWORD: password
                MYSQL_DATABASE: database
            image: nginx:1.10.2
                - 80:80
                - 443:443
            restart: always
                - /mnt/code/basic_php/nginx/conf:/etc/nginx/conf.d
                - /mnt/code/basic_php/api:/code/api
                - /mnt/code/basic_php/nginx:/code/nginx
                - php
                - site
                - php
                - site
            build: php
                - 9000
            restart: always
                - /mnt/code/basic_php/php/conf/php.ini:/usr/local/etc/php/conf.d/custom.ini
                - /mnt/code/basic_php/api:/code/api
                - mysql
            restart: always
            build: site
                - 80
            container_name: site

  • Can't remove or stop a container
  • Accesing Spring-Boot WebApplication running in Docker Container
  • Error building a docker in Windows 10
  • Docker Machine + Docker Compose + Volumes on Ubuntu
  • Docker Add/Copy subdirectory separately
  • Create and add a Marathon application
  • One Solution collect form web for “docker invalid characters for local volume name”

    After a few hours searching the web, I finally found what i was looking for. Like Wolfgang Blessen said in the comments below my question, the problem was indeed a Windows Path problem.

    If you dont want docker to automatically convert paths windows to unix, you need to add the COMPOSE_CONVERT_WINDOWS_PATHS environment variable with a value of 0 like explained here: link

    Docker will be the best open platform for developers and sysadmins to build, ship, and run distributed applications.