Install metabase on linux

Installing and Running Metabase

Metabase is built and packaged as a Java jar file and can be run anywhere that Java is available. Below we provide detailed instructions on how to install and run Metabase in a variety of common configurations.

Running the Jar File

This is the simplest and most basic way of running Metabase. Here we’ll cover the general requirements for running Metabase and provide some information about how to customize your installation for any scenario.

Running the Mac Application

Metabase provides a binary Mac OS X application for users who are interested in trying Metabase on a Mac system.

Running on Docker

If you are using Docker containers and prefer to manage your Metabase installation that way then we’ve got you covered. This guide discusses how to use the Metabase Docker image to launch a container running Metabase.

Cloud Platforms

Running on AWS Elastic Beanstalk

Step-by-step instructions on how to deploy Metabase on Elastic Beanstalk using RDS. This is the most common way to run Metabase in production.

Running on Azure Web Apps

Step-by-step instructions on how to deploy Metabase on Azure Web Apps with a private Azure Database.

Running on Heroku

Currently in beta. We’ve run Metabase on Heroku and it works just fine, but it’s not hardened for production use just yet. If you’re up for it then give it a shot and let us know how we can make it better!

Running on Debian as a service

Community support only at this time, but learn how to deploy Metabase as a service on Debian (and Debian-based) systems. Simple, guided, step-by-step approach that will work on any VPS.

Running on Kubernetes

Community Helm chart for running Metabase on Kubernetes.

Источник

Installing and running Metabase

There are a lot of different ways to run Metabase, both on prem and in the cloud.

To follow along with our tutorials, you’ll need a working Metabase installation. If your Metabase is already up and running, skip ahead to Getting started with Metabase, or check out A tour of Metabase for a high-level overview.

The simplest way to get up and running is to run the JAR file. Just follow the instructions in the docs, and you can ignore the rest of this page.

Running Metabase in production

There are two basic ways to run Metabase in production: you can sign up for Metabase Cloud, or host Metabase yourself. If you’re not sure which way is right for you, check out How to run Metabase in production.

Different ways to install and run Metabase

We package Metabase as a Java JAR file, and you can run it anywhere Java is available. We also offer a few options for running the JAR:

Method	Description
JAR	The simplest way to get up and running.
Docker	If you prefer to manage Metabase using a Docker container.
Mac Application	Metabase provides a binary Mac OS X application for users who want to try Metabase on a Mac system.

Running Metabase on cloud platforms

You can also run Metabase in the cloud. We offer our own version, and provide some guides for setting up Metabase on other platforms.

Metabase Cloud

Our hosted version, Metabase Cloud. All you need to do is sign up for a free trial, and you’re off to the races.

AWS Elastic Beanstalk

Step-by-step instructions on how to deploy Metabase on Elastic Beanstalk using RDS.

Heroku

Currently in beta. We’ve run Metabase on Heroku and it works just fine, but it’s not hardened for production use just yet. If you’re up for it then give it a shot and let us know how we can make it better!

Debian as a service

Community support only at this time, but learn how to deploy Metabase as a service on Debian (and Debian-based) systems. Simple, guided, step-by-step approach that will work on any VPS.

Kubernetes

Community Helm chart for running Metabase on Kubernetes.

Источник

Running Metabase on Debian as a service with nginx

For those people who don’t (or can’t) use Docker in their infrastructure, there’s still a need to easily setup and deploy Metabase in production. On Debian-based systems, this means registering Metabase as a service that can be started/stopped/uninstalled.

Note: This is just a bare-bones recipe to get you started. Anyone can take it from here to do what they need to do on their systems, and should follow best practices for setting up and securing the rest of their server.

Assumptions

The core assumption in this guide:

• You will run Metabase using the metabase.jar file
• You already have nginx and postgres (or another supported database) running on your server
• You will use environment variables to configure your Metabase instance
• You have sudo access on your server

Create an unprivileged user to run Metabase and give him acces to app and logs

For security reasons we want to have Metabase run as an unprivileged user. We will call the user simply metabase . Further we will create the files we will need later for logging and configuration of Metabase, and apply the correct security settings for our unprivileged user.

Create a Metabase Service

Every service needs a script that tells systemd how to manage it, and what capabilities it supports. Services are typically registered at /etc/systemd/system/ . So, a Metabase service should live at /etc/systemd/system/metabase.service .

The Metabase service file

Create the /etc/systemd/system/metabase.service service file and open it in your editor:

In /etc/systemd/system/metabase.service , replace configurable items (they look like ) with values sensible for your system. The Metabase script below has extra comments to help you know what everything is for.

Create syslog conf

Next we need to create a syslog conf to make sure systemd is able to handle the logs properly.

Restart the syslog service to load the new config.

Environment Variables for Metabase

Environment variables provide a good way to customize and configure your Metabase instance on your server. On Debian systems, services typically expect to have accompanying configs inside etc/default/ .

The Metabase config file

Open your /etc/default/metabase environment config file in your editor:

In /etc/default/metabase , replace configurable items (they look like ) with values sensible for your system. Some Metabase configs have available options, some of which are shown below, separated by | symbols:

Final Steps

The best part of setting up Metabase as a service on a Debian-based system is to be confident it will start up at every system boot. We only have a few more quick steps to finish registering our service and having Metabase up and running.

Ensure your database is ready

If you’re running postgres or some other database, you need to ensure you’ve already followed the instructions for your database system to create a database for Metabase, as well as a user that can access that database. These values should match what you’ve set in your Metabase config for the MB_DB_TYPE , MB_DB_DBNAME , MB_DB_USER , and MB_DB_PASS environment variables. If you don’t have your database properly configured, Metabase won’t be able to start.

Ensure nginx is setup to proxy requests to Metabase

Getting into too much detail about configuring nginx is well outside the scope of this guide, but here’s a quick nginx.conf file that will get you up and running.

Note: The nginx.conf below assumes you are accepting incoming traffic on port 80 and want to proxy requests to Metabase, and that your Metabase instance is configured to run on localhost at port 3000 . There are several proxy directives you may care about, so you should check those out further in the Official nginx docs.

Register your Metabase service

Now, it’s time to register our Metabase service with systemd so it will start up at system boot. We’ll also ensure our log file is created and owned by the unprivileged user our service runs the metabase.jar as.

Once we are ok here, enable the service to startup during boot.

That’s it!

Now, whenever you need to start, stop, or restart Metabase, all you need to do is:

Источник

Install metabase on linux

Copy raw contents

Copy raw contents

Installing and Running Metabase

Metabase is built and packaged as a Java jar file and can be run anywhere that Java is available. Below we provide detailed instructions on how to install and run Metabase in a variety of common configurations.

This is the simplest and most basic way of running Metabase. Here we’ll cover the general requirements for running Metabase and provide some information about how to customize your installation for any scenario.

Metabase provides a binary Mac OS X application for users who are interested in trying Metabase on a Mac system.

If you are using Docker containers and prefer to manage your Metabase installation that way then we’ve got you covered. This guide discusses how to use the Metabase Docker image to launch a container running Metabase.

Step-by-step instructions on how to deploy Metabase on Elastic Beanstalk using RDS. This is the most common way to run Metabase in production.

Step-by-step instructions on how to deploy Metabase on Azure Web Apps with a private Azure Database.

Currently in beta. We’ve run Metabase on Heroku and it works just fine, but it’s not hardened for production use just yet. If you’re up for it then give it a shot and let us know how we can make it better!

Community support only at this time, but learn how to deploy Metabase as a service on Debian (and Debian-based) systems. Simple, guided, step-by-step approach that will work on any VPS.

Community Helm chart for running Metabase on Kubernetes.

Источник

Setting up Metabase

This guide will help you set up Metabase once you’ve gotten it installed. If you haven’t installed Metabase yet, you can get Metabase here.

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

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 since it will be used 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.

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.

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 can connect to your database. Sweet, sweet data at last. Just go ahead and put your info into this form and click Next.

For more on connecting to databases, see 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 a bunch to 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.

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!

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 🙂

Next: Getting started with Metabase

For a quick overview of how to use Metabase, head over to the Getting Started Guide.

For information on adding team members, connecting additional databases, configuring Metabase settings, and more, check out the Admin Guide.

Источник