> For the complete documentation index, see [llms.txt](https://docs.neevcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neevcloud.com/neevcloud-guide/neevcloud-knowledgebase/how-to-install-metabase-on-ubuntu-22.04.md).

# How to Install Metabase on Ubuntu 22.04

Metabase is an open-source business intelligence tool that lets you visualize data, build dashboards, and ask questions about data all through an intuitive web interface. It connects to various databases like PostgreSQL, MySQL, MongoDB, etc., and provides simple tools for analysis and reporting.

Here’s a step-by-step guide to get Metabase up and running:

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

* Launch the [Ubuntu 22.04 instance](https://docs.neevcloud.com/neevcloud-products/computes/getting-started-launch-vms) on Neevcloud
* Access the server using [SSH](https://docs.neevcloud.com/neevcloud-products/computes/getting-started-launch-vms#ssh).
* Java 11 or higher installed.
* Port 3000 is open for web access.

## Update && Upgrade the system <a href="#update-and-and-upgrade-the-system" id="update-and-and-upgrade-the-system"></a>

First, ensure your package list is up to date to avoid any issues with outdated packages

```
sudo apt-get update -y
sudo apt-get upgrade -y
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2F8gpZoaTJSOeinfmWFsSf%2Fimage.avif?alt=media&amp;token=7afbe343-08e9-4bfa-87f9-3c2d1361b998" alt=""><figcaption></figcaption></figure>

## Install Java (Required for Metabase)

Metadabse runs on java, install openJDk.

```
sudo apt install -y openjdk-11-jdk
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FcpcJvXZlLHXIIthDHXnH%2Fimage.png?alt=media&amp;token=15fb71c0-4df2-4f3f-b5ef-e331b2fa75af" alt=""><figcaption></figcaption></figure>

Verify Java is installed

```
sudo java -version
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FFXCM6w0IMLxAnqfYrh0J%2Fimage.png?alt=media&amp;token=77acedd0-d2aa-4f8e-a5ce-b060ab7af12b" alt=""><figcaption></figcaption></figure>

## Download the Metabase JAR File <a href="#id-9270" id="id-9270"></a>

Now create a one-directory, and permit to execute the jar file.

```
sudo mkdir /app
sudo chmod 777 /app
```

Navigate to your directory and download the latest Metabase JAR file:

```
wget https://downloads.metabase.com/v0.48.5/metabase.jar
```

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FDPy4B8RXiYDEb4yqkym4%2Fimage.png?alt=media&amp;token=e71daeb9-8463-4e66-aa86-77c1e2f94467" alt=""><figcaption></figcaption></figure>

## Running Metabase as a Systemd Service <a href="#e0a6" id="e0a6"></a>

To ensure Metabase starts automatically on reboot, configure it as a systemd service.

### **Create a systemd service file:**

```
sudo vi /etc/systemd/system/metabase.service
```

```
[Unit]
Description=Metabase Server
After=network.target

[Service]
ExecStart=/usr/bin/java -jar /app/metabase.jar
WorkingDirectory=/app
Restart=always
User=root
Group=root

[Install]
WantedBy=multi-user.target
```

Adjust the **file path** if you downloaded Metabase to a different directory.

### **Reload systemd and start Metabase:**

```
sudo systemctl daemon-reload
sudo systemctl enable metabase
sudo systemctl start metabase
```

### **Check service status:**

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FYVlmwqICcvUrYBWtOjtu%2Fimage.png?alt=media&amp;token=fc252467-2135-47ef-9f6e-ba46f83e4ab4" alt=""><figcaption></figcaption></figure>

Access the Metabase Web Interface

Once Metabase is running, open your browser and go to: <http://your-server-ip:3000>

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FBZ83jptsQyeyn2PRwk5U%2Fimage.png?alt=media&amp;token=fbbd03d3-f1b7-4bb6-a172-8bd590dd92cb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1876135298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEC5NwtFshv6EATOemuUn%2Fuploads%2FNHnjx0NftLT69S6yqKdq%2Fimage.png?alt=media&amp;token=e833abc4-61f2-4d6d-b489-8d888f8a4feb" alt=""><figcaption></figcaption></figure>
