Installing and Starting Management Center

This topic explains the options for installing and starting Management Center, using Docker or the binary packages.

Before you Begin

Review the requirements and make sure that you meet them.

Using Docker

  1. Install Docker.

  2. Check that Docker is correctly installed.

    docker version
  3. If you do not see a version number, see the Docker docs for troubleshooting information.

  4. Pull the Management Center Docker image from Docker Hub.

    docker pull hazelcast/management-center:5.0.4
  5. Start the Management Center service

    docker run --rm -p 8080:8080 hazelcast/management-center:5.0.4

Please see more details at DockerHub.

Using Binary Packages

Hazelcast Management Center is included in the Hazelcast download package. You can download it from the download page of the Hazelcast website.

When a new version of Hazelcast is released, it comes with a compatible version of Management Center.

There may be times when a new Management Center version is released before a new version of Hazelcast. In that case, you may download the new Management Center from its download page as a separate package.

If you choose to install Management Center using binary packages, you have the following options to start the Management Center service:

  • Start Hazelcast Management Center from the command line.

  • Use the scripts that come with the download package.

  • Deploy the file hazelcast-management-center-5.0.4.war on your Java application server/servlet container.

For all the starting options you can preconfigure a cluster in Management Center by setting the following environment variables:

  • MC_DEFAULT_CLUSTER_MEMBERS variable should contain a comma-separated list of the cluster member addresses.

  • MC_DEFAULT_CLUSTER variable should contain the cluster name and defaults to dev if not provided.

Using Scripts in the Package

As another option, you can use the mc-start scripts, which come with the download package in `bin/ folder, to start the Management Center. You can find these scripts under the extracted directory.

Using the Command Line

Extract the Hazelcast or Management Center package. The extracted directory (hazelcast-management-center-5.0.4) contains the hazelcast-management-center-5.0.4.jar file.

You can start this file directly from the command line using the following command:

java -jar hazelcast-management-center-5.0.4.jar

Deploying to Application Server

Instead of starting at the command line, you can deploy the Management Center to your application server (Tomcat, Jetty, etc.).

SNAPSHOT versions

If you want to use the most recent development (snapshot) version of Management Center, then you can run it by using the latest-snapshot tag in Docker:

docker run --rm -p 8080:8080 --pull=always hazelcast/management-center:latest-snapshot

In these cases, it can be useful to query the build information to be able to tell what revision are you using. You can find version metadata about a running instance of Management Center at the following endpoint: <hazelcast.mc.home>/api/buildInfo. This endpoint returns JSON.

Next Steps

For an end-to-end getting started, see Get Started with Management Center in Docker.

To learn how to connect to a cluster, see Cluster Connections.

To serve Management Center over HTTPS instead of HTTP, see Serve Management Center over HTTPS.

For the options you can provide when starting Management Center, see System Properties and Environment Variables.

Enterprise topics

To explore the licensed features of Management Center, see the following:

See also the following for the Management Center features that rely on your cluster’s enterprise capabilities: