Skip to content

Install script

Use this page when you want to install the LunarGate binary with the hosted Linux installer and control where it lands.

What the script installs

The install script places only the lunargate binary on your machine.

It does not create or install a config.yaml for you. After installation, create your own config file and run lunargate --config ./config.yaml.

Default behavior

The standard install command is:

curl -fsSL https://get.lunargate.ai/install.sh | sh

That is equivalent to:

curl -fsSL https://get.lunargate.ai/install.sh | sh -s -- install

By default, the script tries to install lunargate to /usr/local/bin.

If /usr/local/bin is not writable and your shell has a writable HOME, the script automatically falls back to:

~/.local/bin

If the chosen directory is not already on your PATH, the script prints a hint at the end.

Choose a custom install path

To install somewhere else, set INSTALL_PATH before running the script:

curl -fsSL https://get.lunargate.ai/install.sh | INSTALL_PATH="$HOME/.local/bin" sh

You can use any writable directory.

Note

Put INSTALL_PATH on the sh side of the pipe. Setting it only for curl does not pass it to the installer process.

Available commands

The script supports four commands:

  • install installs LunarGate and is the default when you omit a command
  • update downloads and installs the latest release over the current binary
  • uninstall removes the installed lunargate binary
  • help prints usage information

Update LunarGate

To refresh an existing installation to the latest release:

curl -fsSL https://get.lunargate.ai/install.sh | sh -s -- update

If your binary lives in a custom directory, use the same INSTALL_PATH you installed with:

curl -fsSL https://get.lunargate.ai/install.sh | INSTALL_PATH="$HOME/.local/bin" sh -s -- update

Uninstall LunarGate

To remove LunarGate:

curl -fsSL https://get.lunargate.ai/install.sh | sh -s -- uninstall

If the binary was installed outside the default locations, point the script at that directory:

curl -fsSL https://get.lunargate.ai/install.sh | INSTALL_PATH="$HOME/.local/bin" sh -s -- uninstall

Typical restricted-environment flow

If you are in Docker, CI, a sandbox, or a machine without write access to /usr/local/bin, this works well:

curl -fsSL https://get.lunargate.ai/install.sh | INSTALL_PATH="$HOME/.local/bin" sh
export PATH="$HOME/.local/bin:$PATH"
lunargate --help

Next step

After the binary is installed, go back to Quickstart to save a minimal config.yaml and send your first request through the gateway.