Docker Container for TileBoard: "A simple yet highly configurable Dashboard for HomeAssistant"
This repository has been archived on 2021-05-10. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Florian Brinker 7acbe3d55e
All checks were successful
continuous-integration/drone/push Build is passing
Fix date handling for ISO8601 dates
2021-05-10 22:03:02 +02:00
.drone.yml feature: nightly and dev images (#5) 2021-05-10 19:23:50 +00:00
.gitignore Recreate container build and tagging 2021-03-20 18:28:40 +01:00 Change "target" label to "docker" 2021-05-10 18:23:41 +02:00 Fix date handling for ISO8601 dates 2021-05-10 22:03:02 +02:00
Dockerfile Add Download to Dockerfile for more transparency 2021-04-22 22:27:46 +02:00
Dockerfile.nightly feature: nightly and dev images (#5) 2021-05-10 19:23:50 +00:00 Add license 2021-05-09 21:45:13 +00:00 feature: nightly and dev images (#5) 2021-05-10 19:23:50 +00:00

TileBoard Docker-Container

Build Status Docker Pulls

This is a very basic Docker container for TileBoard, "a simple yet highly configurable Dashboard for HomeAssistant".

It contains the sources and starts a simple Python3 webserver to serve TileBoard at port 8000.


You can open any new issues here. The builds are automated on changes of the official TileBoard repository.

Have a look at the Dockerfile.


You have to mount your config.js file into the /tileboard directory of the Docker container. You can see an example config.js file in the official repository.

Versions / Tags

Besides the latest version, you can listen to updates for a specific version:

  • fbrinker/tileboard (same as :latest)
  • fbrinker/tileboard:latest
  • fbrinker/tileboard:2
  • fbrinker/tileboard:2.2
  • fbrinker/tileboard:2.2.0

Additionally, there are nightly and dev builds as follows:

  • fbrinker/tileboard:nightly contains a nightly build of TileBoard's master branch. Use it to have the most bleeding edge changes, which have not made it into a release yet.
  • fbrinker/tileboard:dev bundles TileBoard's source code and runs yarn run dev inside the container. Use it to modify the source, check your changes into GitHub and propose a pull request to TileBoard. See the TileBoard contribution page for details.


Here is an example, using Docker-Compose:

version: '3'

    image: fbrinker/tileboard
      - ./config.js:/tileboard/config.js
      - "8234:8000"

After a docker-compose up -d, you can reach your TileBoard instance under http://[yourhost-or-ip]:8234.

Extended Example

I am using it in my docker-compose file like this, with my config.js, secrets and other customizations:

# Home Assistant TileBoard
  container_name: tileboard
  image: fbrinker/tileboard
  hostname: tileboard
    - ./tileboard/config/config.js:/tileboard/config.js
    - ./tileboard/config/secrets.js:/tileboard/includes/config/secrets.js
    - ./tileboard/config/pages:/tileboard/includes/pages
    - ./tileboard/styles/background.png:/tileboard/images/background.png
    - ./tileboard/styles/custom.css:/tileboard/styles/custom.css
    - "8234:8000"
  restart: unless-stopped
    - homeassistant

Note: You should never expose TileBoard to the web.