archived-teslamate/website/docs/installation/docker.md

title, sidebar_label

title	sidebar_label
Docker install	Docker

This document provides the necessary steps for installation of TeslaMate on a any system that runs Docker. For a walkthrough that provides the necessary steps for manual installation see Manual Install.

This setup is recommended only if you are running TeslaMate on your home network, as otherwise your Tesla API tokens might be at risk. If you intend to expose TeslaMate directly to the internet check out the advanced guides.

Requirements

• Docker (if you are new to Docker, see Installing Docker and Docker Compose)
• A Machine that's always on, so TeslaMate can continually fetch data
• External internet access, to talk to tesla.com

Instructions

1. Create a file called docker-compose.yml with the following content:

   version: "3"
   
   services:
     teslamate:
       image: teslamate/teslamate:latest
       restart: always
       environment:
         - DATABASE_USER=teslamate
         - DATABASE_PASS=secret
         - DATABASE_NAME=teslamate
         - DATABASE_HOST=database
         - MQTT_HOST=mosquitto
       ports:
         - 4000:4000
       volumes:
         - ./import:/opt/app/import
       cap_drop:
         - all
   
     database:
       image: postgres:12
       restart: always
       environment:
         - POSTGRES_USER=teslamate
         - POSTGRES_PASSWORD=secret
         - POSTGRES_DB=teslamate
       volumes:
         - teslamate-db:/var/lib/postgresql/data
   
     grafana:
       image: teslamate/grafana:latest
       restart: always
       environment:
         - DATABASE_USER=teslamate
         - DATABASE_PASS=secret
         - DATABASE_NAME=teslamate
         - DATABASE_HOST=database
       ports:
         - 3000:3000
       volumes:
         - teslamate-grafana-data:/var/lib/grafana
   
     mosquitto:
       image: eclipse-mosquitto:1.6
       restart: always
       ports:
         - 1883:1883
       volumes:
         - mosquitto-conf:/mosquitto/config
         - mosquitto-data:/mosquitto/data
   
   volumes:
     teslamate-db:
     teslamate-grafana-data:
     mosquitto-conf:
     mosquitto-data:
   

2. Start start the docker containers with docker-compose up. To run the containers in the background add the -d flag:

   docker-compose up -d
   

Usage

1. Open the web interface http://your-ip-address:4000
2. Sign in with your Tesla account
3. The Grafana dashboards are available at http://your-ip-address:3000.