Metabase
You can connect your Frappe Cloud database to Metabase to explore data, build dashboards, and create interactive reports using your ERP data.
Overview
Before connecting Metabase, you’ll need to create a read-only database user for your Frappe Cloud site. Once the connection is established, Metabase will automatically synchronize your database schema, allowing you to create dashboards and reports.
Step 1: Create a Database User
Generate a read-only database user for your Frappe Cloud site using the Database Users and Permission Manager.
- Create a read-only database user.
- Wait a few seconds for the configuration to complete.
- Click View Credential to view the connection details.
Keep the following information ready, as it will be required when configuring Metabase:
- Server Name
- Port
- Database Name
- Username
- Password
Step 2: Add the Database in Metabase
- Open your Metabase Dashboard.
- Click Add Database.
- Select MySQL as the database type.
- Enter the database credentials generated in the previous step.
Configure SSL
For a secure connection:
- Enable Use a Secure Connection (SSL).
- Download the server SSL certificate chain.
- Open the certificate file in a text editor.
- Copy the certificate contents and paste them into the Server SSL Certificate Chain field in Metabase.
Important
The SSL option must be enabled, and the server certificate chain must be provided to establish a secure connection between Metabase and your Frappe Cloud database.
Step 3: Save the Connection
After entering all the required information:
- Click Save.
- If the connection is successful, the database will appear in your Metabase database list.
Step 4: Wait for Schema Synchronization
Metabase automatically scans your database after the connection is created.
Allow a few minutes for the schema synchronization to complete. Once finished, you’ll be able to browse your database tables and view their metadata.
Next Steps
After synchronization is complete, you can begin using Metabase to:
- Create dashboards.
- Build reports.
- Explore database tables.
- Visualize ERP and business data.
Best Practice
Always use a read-only database user when connecting third-party business intelligence tools such as Metabase. This keeps your production database secure while allowing safe access for reporting and analytics.