Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Mycroft Docker Development Environment

Build Status


Get image from Docker hub

This repo is updated on dockerhub and you can have it without building it, by simply running the below command.

docker pull mycroftai/docker-mycroft

Build image

Git pull this repository.

git clone

Build the docker image in the directory that you have checked out.

docker build -t mycroft .


To get persistent data and don't have, for example, to pair our instance every time the container is started. You can map a local directory into the container. Just replace the config_dir_on_host with where you want the container mapped on your local machine (e.g. /home/user/mycroft). To get persistent storage of non-default skills, so that they don't have to be re-installed every time the container is started, we map the container's skills directory to a local directory. Just replace the skills_dir_on_host with the desired location (e.g. /home/user/mycroft_skills).

Sounds can be played in the container using pulseaudio, without modifying any config files (Thanks to fsmunoz).

Run the following to start up mycroft:

docker run -d \
-v config_dir_on_host:/root/.mycroft \
-v skills_dir_on_host:/opt/mycroft/skills \
--device /dev/snd \
-e PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native \
-v ${XDG_RUNTIME_DIR}/pulse/native:${XDG_RUNTIME_DIR}/pulse/native \
-v ~/.config/pulse/cookie:/root/.config/pulse/cookie \
-p 8181:8181 \
--name mycroft mycroftai/docker-mycroft

Confirm via docker ps that your container is up and serving port 8181:

docker ps
CONTAINER ID        IMAGE                                                COMMAND                  CREATED             STATUS              PORTS                                            NAMES
692219e23bf2        mycroft                                    "/mycroft/ai/mycro..."         3 seconds ago         Up 1 second >8181/tcp                          mycroft

You should now have a running instance of mycroft that you can interact with via the cli, etc.


At any time you can watch the logs simply by running the bellow command:

docker logs -f mycroft

You can exit out of this docker log command by hitting ctrl + c, the --follow basically turns it into a real tail instead of a cat of the log.

CLI Access

You can interact with the CLI of the container by running the following command, this will connect you to the running container via bash:

docker exec -it mycroft /bin/bash

Once in the container you can do ./ cli to get a interactive CLI to interact with mycroft if needed.

You can hit ctrl + c to exit the cli.

Pairing Instance

After the container has been started you can watch the logs and look for the line that says Pairing Code and use this to pair at

You can filter the logs to get the pairing code as such:

docker logs mycroft | grep "Pairing code:"


You can watch the logs and confirm it installs/deletes skills.


You can install skills into the container with the Mycroft Skills Manager (MSM):

docker exec -it mycroft /opt/mycroft/bin/mycroft-msm install skill-name

So to install the Hello World Skill we can use:

docker exec -it mycroft /opt/mycroft/bin/mycroft-msm install hello-world

For development purposes you can also install Skills directly from Github. So if the Hello World Skill was not in the Mycroft Marketplace, we could use the following:

docker exec -it mycroft /opt/mycroft/bin/mycroft-msm install

Please note: only Skills in the Mycroft Marketplace have been reviewed and verified. We strongly recommend carefully reviewing the code of any Skill you are installing from outside of the Marketplace. This is done completely at your own risk.


You can uninstall a Skill using MSM or by removing the folder location for it:

docker exec -it mycroft /opt/mycroft/bin/mycroft-msm remove hello-world
docker exec -it mycroft rm -rf /opt/mycroft/skills/mycroft-hello-world.mycroftai

Both of these commands would remove the Hello World Skill.