https://github.com/mprove-io/mprove
Open Source Self-service Business Intelligence with Version Control :tada:
https://github.com/mprove-io/mprove
analytics bigquery business-intelligence clickhouse dashboard data-visualization looker metrics postgresql snowflake
Last synced: 25 days ago
JSON representation
Open Source Self-service Business Intelligence with Version Control :tada:
- Host: GitHub
- URL: https://github.com/mprove-io/mprove
- Owner: mprove-io
- License: other
- Created: 2019-03-04T11:24:39.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2026-01-15T17:50:38.000Z (28 days ago)
- Last Synced: 2026-01-15T20:16:01.593Z (28 days ago)
- Topics: analytics, bigquery, business-intelligence, clickhouse, dashboard, data-visualization, looker, metrics, postgresql, snowflake
- Language: TypeScript
- Homepage: https://mprove.io
- Size: 34.3 MB
- Stars: 327
- Watchers: 7
- Forks: 27
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-clickhouse - mprove-io/mprove - Mprove is an open-source self-service Business Intelligence platform with version control, leveraging ClickHouse for high-performance data analytics and flexible deployment options. (Integrations / Data Visualization and Analysis)
README
# Mprove
[Website](https://mprove.io) | [Docs](https://docs.mprove.io)
Mprove is an Open Source Business Intelligence with [Malloy Semantic Layer](https://www.malloydata.dev/)
## Deploy to Kubernetes cluster using Helm Chart
See README in [mprove-helm-charts](https://github.com/mprove-io/mprove-helm-charts)
## Deploy using docker-compose (MacOS / Linux / Windows WSL)
#### 1. Clone github repo to local `mprove` directory
```
git clone https://github.com/mprove-io/mprove.git
```
#### 2. Change directory to `mprove`
```
cd mprove
```
If you open the directory in VS Code, you will be prompted to run Devcontainer.
If you run Devcontainer, you will not be able to run Docker and Docker Compose images inside Devcontainer.
Devcontainer is for development only.
#### 3. Create `mprove_data` directory
```
chmod +x scripts/create-mprove-data.sh
scripts/create-mprove-data.sh
```
#### 4. Run script to create ".env" file with generated values
```
chmod +x scripts/create-env.sh
scripts/create-env.sh
```
#### 5. Modify `.env`
Set most recent Mprove release tag from https://github.com/mprove-io/mprove/releases
```
MPROVE_RELEASE_TAG=
```
Set your real email address. You may need it later to receive transactional emails (for example, to change your password).
```
BACKEND_MPROVE_ADMIN_EMAIL=
```
Change your initial password if necessary. Later changes can only be done through web interface (by sending an email).
```
BACKEND_MPROVE_ADMIN_INITIAL_PASSWORD=
```
Set SMTP parameters to be able to send transactional emails (required if you need to invite more users or change passwords).
```
BACKEND_SMTP_HOST=
BACKEND_SMTP_AUTH_USER=
BACKEND_SMTP_AUTH_PASSWORD=
BACKEND_SEND_EMAIL_FROM_ADDRESS=
BACKEND_SEND_EMAIL_FROM_NAME=
```
#### 6. Run docker images
```
docker-compose up --pull db calc-postgres valkey backend blockml disk front
```
#### 7. Login
Open `http://localhost:3003` in Chrome.
Login using values from `.env` file environment variables:
- `BACKEND_MPROVE_ADMIN_EMAIL`
- `BACKEND_MPROVE_ADMIN_INITIAL_PASSWORD`
Continue with [Quickstart Docs](https://docs.mprove.io/docs/quickstart).
## License
Mprove is distributed under various [Licenses](https://github.com/mprove-io/mprove/blob/master/LICENSE).