Skip to content
Go to file

Latest commit


Git stats


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

Docker Repository on



This is a container intended to run home-assistant for home automation. This is a pre-cursor to my ARM image and will be an automated build for x86_64, where ARM cannot currently be automatically built.

Differences between the x86_64 automated build and ARMv7 builds will be detailed in the ARM repository


Before reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker installation guide for instructions.

SELinux users should try disabling SELinux using the command setenforce 0 to see if it resolves the issue.

If the above recommendations do not help then report your issue along with the following information:

  • Output of the docker version and docker info commands
  • The docker run command or docker-compose.yml used to start the image. Mask out the sensitive bits.
  • Please state if you are using Boot2Docker, VirtualBox, etc.

Getting started


A finished image of this is available on Dockerhub and is the recommended method of installation.

docker pull mitchese/docker-homeassistantlatest

Alternatively you can build the image yourself.

docker build -t mitchese/docker-homeassistant:latest


You will need to develop your own configuration.yaml according to your home. You can clone my configuration as a starting point from my home-assistant configuration repository.

docker run -d --name="home-assistant" \
  --volume /your-config-path:/config \
  --volume /etc/localtime:/etc/localtime:ro \
  --net=host mitchese/docker-homeassistant

If you don't require host networking (for example, if you're not doing any traffic sniffing for presence detection, HUE Bridge emulation, etc.) then you can skip --net=host and replace with -p 8123:8123

docker run -d --name="home-assistant" \
  --volume /your-config-path:/config \
  --volume /etc/localtime:/etc/localtime:ro \
  -p 8123:8123 mitchese/docker-homeassistant


Everything in home-assistant is stored in the configuration folder; By default it will setup a SQLite database which is under home_assistant.db in this folder.

Therefore, the only volume which needs to outlive the container is the your-config-path foldewr.

The Quickstart command already mounts a volume for persistence.

Letsencrypt SSL Certificates

If you want to provide access via https with valid certificates, you can use the letsencrypt certbot from quay to generate the certificate.

You must first forward port 80 from your router to your docker container, in order to pass the certificate authenticaion checks. Then:

sudo mkdir /your-config-path/certs /var/lib/letsencrypt
sudo docker run -it --rm --port 80:80 --name certbot \
                --volume "/your-config-path/certs:/etc/letsencrypt" \
                --volume "/var/lib/letsencrypt:/var/lib/letsencrypt" \
       certonly \
                --standalone --standalone-supported-challenges http-01 \
                --email your@email.address -d

To upgrade the certificate (Every 90 days):

./certbot-auto renew --quiet --no-self-upgrade --standalone \
                     --standalone-supported-challenges http-01

To use the generated certificates:

  api_password: YOUR_SECRET_PASSWORD
  ssl_certificate: /config/certs/live/
  ssl_key: /config/certs/live/



To upgrade to newer releases:

  1. Download the updated Docker image:
docker pull mitchese/docker-homeassistant:latest
  1. Stop the currently running image:
docker stop home-assistant
  1. Remove the stopped container
docker rm -v home-assistant
  1. Start the updated image
docker run -d --name="home-assistant" \
  --volume /your-config-path:/config \
  --volume /etc/localtime:/etc/localtime:ro \
  --net=host mitchese/docker-homeassistant:latest


No description, website, or topics provided.



No releases published
You can’t perform that action at this time.