diff --git a/docs/installation-and-operation/installing-metabase.md b/docs/installation-and-operation/installing-metabase.md index 6fd4bd31042a8e83f172567bfc4ad0c03d4daf55..2dd430d24a4e97d9ca703be80fa9c7651b39be73 100644 --- a/docs/installation-and-operation/installing-metabase.md +++ b/docs/installation-and-operation/installing-metabase.md @@ -24,23 +24,29 @@ Metabase can run anywhere Java is available. If you prefer to use a Docker container, we've got you covered. -### [Running on Podman](running-metabase-on-podman.md) +## Professional services from the Metabase team -Our Docker image is also compatible with Podman. +If you want help with: -### [Building Metabase from source](../developers-guide/start.md) +- Set up +- Training +- Data stack +- Embedding +- Data modeling -To run a development branch of Metabase, check out our [developer's guide](../developers-guide/start.md). +Check out our [professional services](https://www.metabase.com/product/professional-services). -### Other installation options +## Upgrading Metabase -- [Running on Azure Web Apps](running-metabase-on-azure.md) -- [Running on Debian as a service](running-metabase-on-debian.md) +See [Upgrading Metabase](upgrading-metabase.md) -## Upgrading Metabase +## Other installation options -See [Upgrading Metabase](upgrading-metabase.md). +- [Running on Podman](running-metabase-on-podman.md) +- [Building Metabase from source](../developers-guide/start.md) +- [Running on Azure Web Apps](running-metabase-on-azure.md) +- [Running on Debian as a service](running-metabase-on-debian.md) ## Connect with a Metabase Expert -If you’d like more technical resources to set up your data stack with Metabase, connect with a [Metabase Expert](https://www.metabase.com/partners/). +If you’d like more technical resources to set up your data stack with Metabase, connect with a [Metabase Expert](https://www.metabase.com/partners/). \ No newline at end of file diff --git a/docs/installation-and-operation/migrating-from-h2.md b/docs/installation-and-operation/migrating-from-h2.md index 9378c22b728980b07eb89602b6ab9dc1ec939925..549880c9bb7822c1ca5d308aec68968478bad6cf 100644 --- a/docs/installation-and-operation/migrating-from-h2.md +++ b/docs/installation-and-operation/migrating-from-h2.md @@ -7,9 +7,13 @@ redirect_from: # Migrating to a production application database +This page covers how to convert a Metabase that's been using the built-in application database, H2, to a production-ready instance with either PostgreSQL or MySQL/MariaDB. For more on why you should do this, check out [How to run Metabase in production](https://www.metabase.com/learn/administration/metabase-in-production). + +If you'd rather move to Metabase Cloud, check out [Migrate to Metabase Cloud](https://www.metabase.com/docs/latest/cloud/migrate/guide). + ## Metabase's application database -The main difference between a local installation and a production installation of Metabase is the application database. The application database keeps track of all of your Metabase data: your questions, dashboards, collections, and so on. +The main difference between a local installation and a production installation of Metabase is the application database. This application database keeps track of all of your Metabase data: your questions, dashboards, collections, and so on. Metabase ships with an embedded H2 application database that you should avoid using in production. The reason Metabase ships with the H2 database is because we want people to spin up Metabase on their local machine and start playing around with asking questions. diff --git a/docs/installation-and-operation/running-the-metabase-jar-file.md b/docs/installation-and-operation/running-the-metabase-jar-file.md index ae8f6be29014d31ef69754faa0e0a361826691b6..bb9ae6a7e5d03ef8b551478272e4fa7bf43435ee 100644 --- a/docs/installation-and-operation/running-the-metabase-jar-file.md +++ b/docs/installation-and-operation/running-the-metabase-jar-file.md @@ -17,7 +17,7 @@ If you have a token for the [Pro or Enterprise editions](https://www.metabase.co If you have Java installed: -1. [Download the JAR file for Metabase OSS](https://metabase.com/start/oss/jar). +1. [Download the JAR file for Metabase OSS](https://metabase.com/start/oss/jar). If you're on a [Pro](https://www.metabase.com/product/pro) or [Enterprise](https://www.metabase.com/product/enterprise) plan, download the [JAR for the Enterprise Edition](https://downloads.metabase.com/enterprise/latest/metabase.jar). 2. Create a new directory and move the Metabase JAR into it. 3. Change into your new Metabase directory and run the JAR. @@ -27,6 +27,8 @@ 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 `http://localhost:3000/setup`. +If you are using a paid version, be sure to [activate your license](../paid-features/activating-the-enterprise-edition.md). + ## Local installation 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](#production-installation). @@ -45,7 +47,10 @@ If Java isn't installed, you'll need to install Java before you can run Metabase ### 2. Download Metabase -[Download the JAR file for Metabase OSS](https://www.metabase.com/start/oss/jar). +Download the JAR file: + +- [Metabase OSS](https://www.metabase.com/start/oss/jar) +- [Metabase Enterprise/Pro edition](https://downloads.metabase.com/enterprise/latest/metabase.jar) If you want to install the [Pro or Enterprise editions](https://www.metabase.com/pricing) of Metabase, see [Activating your Metabase commercial license](../paid-features/activating-the-enterprise-edition.md). @@ -98,7 +103,7 @@ At this point you're ready to go! You can access your new Metabase server on por You can use another port than 3000 by setting the `MB_JETTY_PORT` [environment variable](../configuring-metabase/environment-variables.md) 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](./migrating-from-h2.md). +If you are using a paid version of Metabase, be sure to [activate your license](../paid-features/activating-the-enterprise-edition.md). ## Production installation @@ -144,7 +149,7 @@ If you need to run the JAR in production, you should run Metabase as a service. 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](./running-metabase-on-debian.md). -## Migrating to a production installation +### 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](migrating-from-h2.md). @@ -156,6 +161,6 @@ If you run into any problems during installation, check out our [troubleshooting See [Upgrading Metabase](upgrading-metabase.md). -## Continue to setup +## Setting up Metabase Now that you’ve installed Metabase, it’s time to [set it up and connect it to your database](../configuring-metabase/setting-up-metabase.md). diff --git a/docs/installation-and-operation/start.md b/docs/installation-and-operation/start.md index f82ebe7b9e4028b5a7e32bb3c6090bf694dfd361..0f3dada48255520a1493ac8c0ceb4f2aaf9b9b25 100644 --- a/docs/installation-and-operation/start.md +++ b/docs/installation-and-operation/start.md @@ -10,28 +10,13 @@ The birth, care, and feeding of your Metabase. Start here. -### [Running the Jar File](running-the-metabase-jar-file.md) +## [Migrating to a production database](./migrating-from-h2.md) -The simplest and most basic way of running Metabase. - -### [Running on Docker](running-metabase-on-docker.md) - -If you prefer to use a Docker container, we've got you covered. - -### [Metabase Cloud](https://www.metabase.com/pricing) - -Our official hosted version, [Metabase Cloud](https://www.metabase.com/pricing). All you need to do is sign up for a free trial, and you're off to the races. - -### Other installation options - -We recommend that you deploy Metabase using a service and cloud provider that you're familiar with. Below are some example setups: - -- [Running on Azure Web Apps](running-metabase-on-azure.md) -- [Running on Debian as a service](running-metabase-on-debian.md) +If you started using Metabase with the default, H2 application database, here's how to migrate your data to a production-ready database. -## [Building Metabase from source](../developers-guide/start.md) +## [Configuring the Metabase application database](./configuring-application-database.md) -To run a development branch of Metabase, check out our [developer's guide](../developers-guide/start.md). +Use environment variables to set up your application database. ## [Backing up Metabase application data](./backing-up-metabase-application-data.md) @@ -41,15 +26,11 @@ How to back up your Metabase data: questions, dashboards, and other application How to safely upgrade your Metabase. -## [Migrating from H2](./migrating-from-h2.md) - -If you started using Metabase with the default, H2 application database, here's how to migrate your data to a production-ready database. - -## [Creating an RDS database on AWS](./creating-RDS-database-on-AWS.md) +## [Serialization](./serialization.md) -How to use an RDS instance as your application database. +Export your questions, dashboards, and more as YAML files that you can check into version control. -## [Monitoring your metabase](./monitoring-metabase.md) +## [Monitoring your Metabase](./monitoring-metabase.md) Monitor your Metabase with JMX. @@ -61,6 +42,10 @@ Export Metabase metrics for viewing with Prometheus. Rest in peace, Internet Explorer. +## [Command line commands](./commands.md) + +Metabase's CLI. + *** If you’d like more technical resources to set up your data stack with Metabase, connect with a [Metabase Expert](https://www.metabase.com/partners/).