Skip to main content

Install LayerG Binary for macOS

This tutorial will show you how to setup and run LayerG binary and its prerequisites on macOS.

The binary setup allows you to install and manage LayerG without Docker but it requires extra steps to setup and manage:

  • Installing CockroachDB or PostgreSQL
  • Manually applying database migrations
  • Manually upgrading LayerG and its database to newer versions
  • Configuring services or manually starting LayerG and its database

Prerequisites​

Operating system​

Before proceeding ensure that you are running macOS 10.9 (Mavericks) or higher.

Next, install a supported database engine.

CockroachDB​

LayerG officially supports CockroachDB v20.0 or higher, with queries optimised for its storage engine.

Install CockroachDB via one the official supported methods:

  • Homebrew
  • Binary
  • Build from source

PostgreSQL​

LayerG unofficially supports PostgreSQL 9.6 or higher for development environments only.

Install PostgreSQL via:

Download LayerG​

Get the latest binary release of LayerG server for macOS:

  1. Download a release from the LayerG GitHub repo releases page
  2. Extract the archive, optionally rename and move the folder to a suitable location

Running LayerG​

Before starting LayerG server you will need to run:

  1. Your chosen database, CockroachDB or PostgreSQL.
  2. LayerG database migrations if it is your first time running LayerG or you have upgraded LayerG versions.

LayerG migrations​

If this is your first time running LayerG or you have upgraded LayerG versions, you may need to run LayerG database migrations. If you are unsure, running migrations again is safe.

If you are running CockroachDB with the default configuration, running migrations is straightforward with no additional options necessary.

If you are using PosgreSQL you will need to supply your database server address, user and password.

To run LayerG migrations, navigate to your LayerG directory and run the following:

CockroachDB

./LayerG migrate up

PostgreSQL

./LayerG migrate up --database.address postgres:[email protected]:5432

LayerG server​

To start LayerG server with CockroachDB or PostgreSQL, navigate to your LayerG directory and run the following:

CockroachDB

./LayerG

PostgreSQL

./LayerG --database.address postgres:[email protected]:5432

You will need to provide the same database.address value used for running LayerG PostgreSQL database migrations.

LayerG Console​

You can also access the LayerG Console by navigating your browser to 127.0.0.1:7351:

LayerG console

When prompted to login, the default credentials are admin:password. These can be changed via configuration file or command-line flags.

Configuration file​

There are many configuration options available that you can customize for your LayerG server.

Next steps​

With your LayerG server now up and running with the desired configuration, you can get started with your preferred client SDK.