title: “Install via Docker Compose” description: > The steps to install DevLake via Docker Compose sidebar_position: 1

Prerequisites

Launch DevLake

  • Commands written like this are to be run in your terminal.
  1. Download docker-compose.yml and env.example from latest release page into a folder.
  2. Rename env.example to .env. For Mac/Linux users, please run mv env.example .env in the terminal. This file contains the environment variables that the Devlake server will use. Additional ones can be found in the compose file(s).
  3. Run docker-compose up -d to launch DevLake.

Configure and collect data

  1. Visit config-ui at http://localhost:4000 in your browser to configure and collect data.
    • Please follow the tutorial
    • devlake takes a while to fully boot up. if config-ui complaining about api being unreachable, please wait a few seconds and try refreshing the page.
  2. Click View Dashboards button in the top left when done, or visit localhost:3002 (username: admin, password: admin).
    • We use Grafana as a visualization tool to build charts for the data stored in our database.
    • Using SQL queries, we can add panels to build, save, and edit customized dashboards.
    • All the details on provisioning and customizing a dashboard can be found in the Grafana Doc.

Upgrade to a newer version

Support for database schema migration was introduced to DevLake in v0.10.0. From v0.10.0 onwards, users can upgrade their instance smoothly to a newer version. However, versions prior to v0.10.0 do not support upgrading to a newer version with a different database schema. We recommend users to deploy a new instance if needed.