Running the Metabase OSS JAR file
To run the free, Open Source version of Metabase via a JAR file, you will need to have a Java Runtime Environment (JRE) installed on your system.
If you have a token for the Pro or Enterprise editions of Metabase, see Activating your Metabase commercial license.
The quick start is intended for running Metabase locally. See below for instructions on running Metabase in production.
If you have Java installed:
- Download the JAR file for Metabase OSS.
- Create a new directory and move the Metabase JAR into it.
- Change into your new Metabase directory and run the JAR.
java -jar metabase.jar
Metabase will log its progress in the terminal as it starts up. Wait until you see “Metabase Initialization Complete” and visit
If you just want to try Metabase out, play around with Metabase, or just use Metabase on your local machine, Metabase ships with a default application database that you can use. This setup is not meant for production. If you intend to run Metabase for real at your organization, see Production installation.
The below instructions are the same as the quick start above, just with a little more context around each step.
1. Install Java JRE
You may already have Java installed. To check the version, open a terminal and run:
If Java isn’t installed, you’ll need to install it before you can run Metabase. We recommend the latest LTS version of JRE from Eclipse Temurin with HotSpot JVM and x64 architecture, but other Java versions are supported too.
2. Download Metabase
Download the JAR file for Metabase OSS.
If you want to install the Pro or Enterprise editions of Metabase, see Activating your Metabase commercial license.
3. Create a new directory and move the Metabase JAR into it
When you run Metabase, Metabase will create some new files, so it’s important to put the Metabase Jar file in a new directory before running it (so move it out of your downloads folder and put it a new directory).
On posix systems, the commands would look something like this:
Assuming you downloaded to
mv /Users/person/Downloads/metabase.jar ~/metabase
4. Change into your new Metabase directory and run the jar
Change into the directory you created in step 2:
Now that you have Java working you can run the JAR from a terminal with:
java -jar metabase.jar
Metabase will start using the default settings. You should see some log entries starting to run in your terminal window showing you the application progress as it starts up. Once Metabase is fully started you’ll see a confirmation such as:
... 06-19 10:29:34 INFO metabase.task :: Initializing task CheckForNewVersions 06-19 10:29:34 INFO metabase.task :: Initializing task SendAnonymousUsageStats 06-19 10:29:34 INFO metabase.task :: Initializing task SendAbandomentEmails 06-19 10:29:34 INFO metabase.task :: Initializing task SendPulses 06-19 10:29:34 INFO metabase.task :: Initializing task SendFollowUpEmails 06-19 10:29:34 INFO metabase.task :: Initializing task TaskHistoryCleanup 06-19 10:29:34 INFO metabase.core :: Metabase Initialization COMPLETE
At this point you’re ready to go! You can access your new Metabase server on port 3000, most likely at
You can use another port than 3000 by setting the
MB_JETTY_PORT environment variable before running the jar.
Note that in the default configuration Metabase will use a local H2 database for storing all its own application data. This default is meant for simple evaluation or personal use. If you want to run Metabase in production we recommend you migrate away from H2.
The steps are similar to those steps above with two important differences: if you want to run Metabase in production, you’ll want to:
- Use a production application database to store your Metabase application data.
- Run Metabase as a service.
If you’d prefer to use Docker, check out running Metabase on Docker.
Production application database
Here are some databases we support.
For example, say you want to use PostgreSQL. You would get a PostgreSQL service up and running and create an empty database:
You can call your app db whatever you want. And there’s no need to create any tables in that database; Metabase will do that for you. You’ll just need to set environment variables for Metabase to use on startup so Metabase knows how to connect to this database.
You’ll create a directory for your Metabase like in the steps listed above for the Local installation, but when it’s time to run the
java -jar command to start up the JAR, you’ll prefix the command with some environment variables to tell Metabase how to connect to the
metabaseappdb you created:
export MB_DB_TYPE=postgres export MB_DB_DBNAME=metabaseappdb export MB_DB_PORT=5432 export MB_DB_USER=username export MB_DB_PASS=password export MB_DB_HOST=localhost java -jar metabase.jar
The above command would connect Metabase to your Postgres database,
localhost:5432 with the user account
username and password
password. If you’re running Metabase as a service, you’ll put these environment variables in a separate configuration file.
Running the Metabase JAR as a service
If you need to run the JAR in production, you should run Metabase as a service. Running Metabase as a service will:
- Make sure Metabase runs automatically (and stay running).
- Allow you to run Metabase with an unprivileged user (which is good for security).
The exact instructions for how to run Metabase as a service will differ depending on your operating system. For an example of how to set up Metabase as a service, check out Running Metabase on Debian.
Migrating to a production installation
If you’ve been running Metabase with the default H2 application database and your team has already created questions, dashboards, collections and so on, you’ll want to migrate that data to a production application database. And the sooner you do, the better. See Migrating from the H2 database.
If you run into any problems during installation, check out our troubleshooting page.
See Upgrading Metabase.
Continue to setup
Now that you’ve installed Metabase, it’s time to set it up and connect it to your database.