Menu Close Log in Get started


Setting up Metabase

Create an admin account and connect to your data.

This guide will help you set up Metabase once you’ve gotten it installed. If you haven’t installed Metabase yet, you can read installing and running Metabase for details on the different ways you can run Metabase, or checkout our website’s start page.

Start Metabase up for the first time and you’ll see this screen:

<em>Fig. 1</em>. Welcome to Metabase!
Fig. 1. Welcome to Metabase!

Go ahead and click Let’s get started.

Setting up an admin account

The first thing you’ll need to do is set up an admin account. The account you create when you first install Metabase is an admin account by default—handy! If you’ve installed Metabase on a production server, you should be really careful to remember the password for this account. You’ll use this account to add other users, connect to databases, set up email, and more. You can also create additional admin accounts later.

For now, let’s just create an account for ourselves to explore Metabase. Type in your info, and when you’re ready to continue, click the Next button.

<em>Fig. 2</em>. Setting up your account.
Fig. 2. Setting up your account.

Gathering your database info

At this point you’ll need to gather some information about the database you want to use with Metabase. We won’t be able to connect to your database without it, but you’d like to deal with all of this later, that’s okay: just click I'll add my data later. Metabase comes with a Sample Dataset that you can play around with to get a feel for how Metabase works.

If you’re ready to connect, here’s what you’ll need:

  • The hostname of the server where your database lives
  • The port the database server uses
  • The database name
  • The username you use for the database
  • The password you use for the database

If you don’t have this information handy, the person responsible for administering the database should have it.

Connect to your database

Now that you have your database info, you’re ready to connect to your database. Sweet, sweet data at last. Just go ahead and put your info into this form and click Next.

<em>Fig. 3</em>. Adding your connection details to connect Metabase to your database.
Fig. 3. Adding your connection details to connect Metabase to your database.

For more on connecting to a database, check out our docs on adding and managing databases.

Usage data preferences

One last quick thing that you’ll have to decide is if it’s okay for us to collect some anonymous info about how you use the product—it helps us make Metabase better. Like the box says:

  • Metabase never collects anything about your data or question results.
  • All collection is completely anonymous.
  • Collection can be turned off at any point in your admin settings.
<em>Fig. 4</em>. Allowing Metabase to collect anonymous usage events.
Fig. 4. Allowing Metabase to collect anonymous usage events.

If you’re ready to start using Metabase, go ahead and click Next.

Staying in touch

At this point you are all set and ready to use Metabase. Since we like keeping in touch with our friends we made it easy to sign up for our newsletter (infrequent emails) with a single click!

<em>Fig. 5</em>. Sign up for our newsletter to stay up to date on the latest at Metabase.
Fig. 5. Sign up for our newsletter to stay up to date on the latest at Metabase.

Once you’re done here simply follow the link to Take me to Metabase. And if you decided to skip the newsletter sign-up it’s cool, we still like you :)

Thanks for your feedback!

Get articles like this one in your inbox every month