diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index c4658cc5..0f11dad3 100644 --- a/docs/getting-started/README.md +++ b/docs/getting-started/README.md @@ -2,57 +2,72 @@ ## Installation -Currently you can install Lula a couple different ways. A brew formulae is in the plan, but not currently implemented. Lula is currently only compatible with Linux/MacOS distributions. +Currently, you can install Lula from Repository Releases, Homebrew, or by building from source. Lula is compatible only with Linux and macOS distributions. + +### Repository Release + +1. Navigate to the Latest Release Page: + Open your web browser and go to the following URL to access the latest release of Lula: + + [https://github.com/defenseunicorns/lula/releases/latest](https://github.com/defenseunicorns/lula/releases/latest) + +2. Download the Binary: + On the latest release page, find and download the appropriate binary for your operating system. E.g., `lula__Linux_amd64` + +3. Download the checksums.txt: + In the list of assets on the release page, locate and download the checksums.txt file. This file contains the checksums for all the binaries in the release. + +4. Verify the Download: + After downloading the binary and checksums.txt, you should verify the integrity of the binary using the checksum provided: + * Open a terminal and navigate to the directory where you downloaded the binary and checksums.txt. + * Run the following command to verify the checksum if using Linux: + + ```shell + sha256sum -c checksums.txt --ignore-missing + ``` + + * Run the following command to verify the checksum if using MacOS: + + ```shell + shasum -a 256 -c checksums.txt --ignore-missing + ``` + +5. On most Linux distributions, install the binary onto your $PATH by moving the downloaded binary to the /usr/local/bin directory: + + ```shell + sudo mv ./download/path/lula__Linux_amd64 /usr/local/bin/lula + +### Homebrew + +1) [Homebrew](https://brew.sh/) is a package manager for macOS and Linux. You can install Lula with Homebrew by running the following: + + ```shell + brew tap defenseunicorns/tap && brew install lula + ``` ### From Source 1) Clone the repository to your local machine and change into the `lula` directory + ```shell git clone https://github.com/defenseunicorns/lula.git && cd lula ``` 2) While in the `lula` directory, compile the tool into an executable binary. This outputs the `lula` binary to the `bin` directory. + ```shell make build ``` 3) On most Linux distributions, install the binary onto your $PATH by moving the downloaded binary to the /usr/local/bin directory: - ```shell - sudo mv ./bin/lula /usr/local/bin/lula - ``` - -### Download -1) Navigate to the Latest Release Page: -Open your web browser and go to the following URL to access the latest release of Lula: -https://github.com/defenseunicorns/lula/releases/latest - -2) Download the Binary: -On the latest release page, find and download the appropriate binary for your operating system. E.g., `lula__Linux_amd64` - -3) Download the checksums.txt: -In the list of assets on the release page, locate and download the checksums.txt file. This file contains the checksums for all the binaries in the release. - -4) Verify the Download: -After downloading the binary and checksums.txt, you should verify the integrity of the binary using the checksum provided: - * Open a terminal and navigate to the directory where you downloaded the binary and checksums.txt. - * Run the following command to verify the checksum if using Linux: - ```shell - sha256sum -c checksums.txt --ignore-missing - ``` - * Run the following command to verify the checksum if using MacOS: - ```shell - shasum -a 256 -c checksums.txt --ignore-missing - ``` - -5) On most Linux distributions, install the binary onto your $PATH by moving the downloaded binary to the /usr/local/bin directory: ```shell - sudo mv ./download/path/lula__Linux_amd64 /usr/local/bin/lula + sudo mv ./bin/lula /usr/local/bin/lula ``` ## Quick Start -See the following tutorials for some introductory lessons on how to use Lula. If you are unfamiliar with Lula, the best place to start is the "Simple Demo". +See the following tutorials for some introductory lessons on how to use Lula. If you are unfamiliar with Lula, the best place to start is the "Simple Demo". ### Tutorials @@ -67,4 +82,4 @@ Developing Lula Validations can sometimes be more art than science, but generall ### Configuration -Lula supports the addition of a configuration file for specifying CLI flags and templating values. See our [configuration](./configuration.md) guide for more information. \ No newline at end of file +Lula supports the addition of a configuration file for specifying CLI flags and templating values. See our [configuration](./configuration.md) guide for more information.