ContextQMD
Back to Teslamate

Upgrading to a new version

website/docs/upgrading.mdx

3.0.03.1 KB
Original Source

:::info Check out the release notes before upgrading! :::

:::note Create a backup before updating. If you are using docker-compose, you are using Docker Compose v1, which has been deprecated. Docker Compose commands refer to Docker Compose v2. Consider upgrading your docker setup, see Migrate to Compose V2 :::

import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem";

<Tabs defaultValue="docker" values={[ { label: 'Docker', value: 'docker', }, { label: 'Manual install (Debian)', value: 'manual_debian', }, { label: 'Manual install (FreeBSD)', value: 'manual_freebsd', }, ]}> <TabItem value="docker">

Within the directory where the YML file is located, pull the new images:

bash
docker compose pull

and restart the stack with docker compose up. To run the containers in the background add the -d flag:

bash
docker compose up -d
</TabItem> <TabItem value="manual_debian">

  1. Pull the new changes from the git repository, checkout the new version and then build the new release:

    bash
    git pull
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

mix deps.get --only prod
npm install --prefix ./assets && npm run deploy --prefix ./assets

rm -rf _build
MIX_ENV=prod mix do phx.digest, release --overwrite

  2. Most upgrades requires to run new database migrations. If so continue with the following command:

    bash
     _build/prod/rel/teslamate/bin/teslamate eval "TeslaMate.Release.migrate"

    Note, you may need to include environment variables when running this step:

    bash
     DATABASE_USER=teslamate DATABASE_PASS=super_secret_password DATABASE_NAME=teslamate DATABASE_HOST=localhost MQTT_HOST=your_MQTT_host(HomeAssistant in my case) _build/prod/rel/teslamate/bin/teslamate eval "TeslaMate.Release.migrate"

  3. Finally, re-import the Grafana dashboards:

    bash
    LOGIN="user:pass" ./grafana/dashboards.sh restore
</TabItem> <TabItem value="manual_freebsd">

  1. Pull the new changes from the git repository, checkout the new version and then build the new release:

    bash
    bash

git pull
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

mix deps.get --only prod
npm install --prefix ./assets && npm run deploy --prefix ./assets

rm -rf _build
export MIX_ENV=prod
mix do phx.digest, release --overwrite

  2. Most upgrades requires to run new database migrations. If so continue with the following command:

    bash
     _build/prod/rel/teslamate/bin/teslamate eval "TeslaMate.Release.migrate"

    Note: you may need to include environment variables as part of this step:

    bash
     DATABASE_USER=teslamate DATABASE_PASS=super_secret_password DATABASE_NAME=teslamate DATABASE_HOST=localhost MQTT_HOST=your_MQTT_host(HomeAssistant in my case) _build/prod/rel/teslamate/bin/teslamate eval "TeslaMate.Release.migrate"

  3. Finally, re-import the Grafana dashboards:

    bash
    bash
export LOGIN="user:pass"
./grafana/dashboards.sh restore
</TabItem> </Tabs>