Skip to main content

LayerG Commands

Day to day operation of LayerG is straightforward, requiring minimal intervention. There are just a few LayerG commands available, and only three to keep in mind:

LayerG

Running the LayerG command by itself will start the server with the default configuration. You can override the configuration default (and configuration file parameters) using command line flags.

migrate

The LayerG binary contains the schema and a way to upgrade an existing database schema. When you first run LayerG, you need to setup the database schema that LayerG interacts with. Similarly, when a new LayerG version is released, you need to migrate the data schema to that of the new version.

CommandDescription
migrate upCreates and updates the database schema to the latest version required by LayerG. By default, the schema is updated sequentially to the latest available.
migrate downDowngrades the database schema to the version requested. By default, it downgrades one schema change at a time.
migrate redoDowngrades one schema change, and re-applies the change.
migrate statusProvides information on the schemas currently applied to the database, and if there are any unapplied schemas.
FlagDescription
database.addressDatabase node to connect to. It should follow the form of username:password@address:port/dbname (postgres:// protocol is appended to the path automatically). Defaults to root@localhost:26257.
--limitNumber of migrations to use when running either up, down, or redo.

config

LayerG comes with a default configuration which can be overridden by using a YML Configuration file or by passing command line flags like below:

LayerG --config path/to/config.yml --database.address root@localhost:26257 --database.address root@machine-2:26257

Command line flags override options set in a config file. Configuration file overrides default config options.

Have a look at Configuration documentation for the complete list of configuration flags.

version

Use the version command to see the semantic version of your LayerG server instance. For example:

LayerG --version
3.3.0+83fc6fbc

check

The check command will parse any command line arguments to look up the runtime path, where the server will scan for Lua and Go library files.

help

Use the help command to display all available configuration flags. These are also available on the Configurations page.

LayerG --help