Skip to main content

Updating Lightdash to the latest version

Local deploymentsโ€‹

If you're running Lightdash on your own laptop using Docker, you just need to instruct Docker to pull the latest version of Lightdash:

docker pull lightdash/lightdash

Now restart Lightdash and you'll be upgraded to the latest version.

Kubernetes/helm deploymentsโ€‹

If you install Lightdash into kubernetes using our community helm charts you need to update your helm chart repository and upgrade your deployment.

helm repo update lightdash
helm upgrade -f values.yml lightdash lightdash/lightdash

Heroku deploymentsโ€‹

Follow these instructions if you used the "deploy to heroku" button to deploy Lightdash.

1. Fork the Lightdash repository on Githubโ€‹

Create a github account if needed, login, and hit "fork" on the Lightdash GitHub repo for heroku

screenshot-fork-github

2. Connect Heroku app to Github repoโ€‹

Navigate to your Heroku dashboard and select the Lightdash app you want to upgrade.

Under the "Deploy" tab for your app, follow these steps:

  1. Scroll to "Deployment method" and select "GitHub"
  2. You may be asked to sign-in to github to link your account with Heroku
  3. Scroll to "Connect to Github"
  4. Select your user and search for the "lightdash-deploy-heroku" repo
  5. Click "Connect" for the repository yourusername/lightdash

screenshot-heroku-app-settings

If you've connected successfully you should see the following message:

screenshot-heroku-success

3. Deploy latest Lightdash versionโ€‹

Still in the "Deploy" tab, scroll down to "Manual deploy" and deploy!

screenshot-heroku-manual-deploy

The deploy may take a few minutes, make a coffee and when you see the "View" button you're ready to go! Click "View" and your browser will open the updated Lightdash app.

screenshot-heroku-complete

4. Next stepsโ€‹

Once you've completed steps 1-4 it's much easier to get future updates.

To update your heroku app, head over to your github fork and press "fetch upstream". This will update your fork and then either:

  1. Repeat Step 3 and manually deploy
  2. Configure your Heroku app to deploy automatically when you update your fork