Installing sloctl

Reading time: 0 minute(s) (0 words)

Select your operating system and installation method.

Once installed, continue to Configuring sloctl.

macOS

Homebrew (recommended)

1. Run the following commands:

   brew tap nobl9/sloctl
   brew trust nobl9/sloctl
   brew install sloctl

   💡Homebrew tap trust

   Homebrew 6.0.0 and later require explicit trust for non-official taps before installation.

   If Homebrew reports Warning: Skipping nobl9/sloctl because it is not trusted. Run brew trust nobl9/sloctl to trust it., run brew trust nobl9/sloctl and try again.

   💡Unsupported macOS version

   If Homebrew reports Error: unknown or unsupported macOS version: :dunno, run brew update-reset and try again.

2. Verify the installation:

   sloctl version

Script

The installation script requires Bash and a minimal set of GNU utilities.

Run the script with curl:

curl -fsSL https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash | bash

If curl is not available, use wget:

wget -O - -q https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash | bash

To inspect the script before you run it, download it first:

curl -fsSL -o install.bash https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash
chmod 700 install.bash
./install.bash --help

After inspection, run the downloaded script:

./install.bash

Verify the installation:

sloctl version

Prebuilt binary

1. Download the appropriate prebuilt binary from the latest sloctl release.

   Choose darwin for macOS, with arm64 for Apple Silicon or amd64 for Intel processors.

2. Place the binary in your system path and rename it sloctl.

3. Grant executable permission to the binary:

   sudo mkdir -p /usr/local/bin
   sudo cp ~/Downloads/sloctl /usr/local/bin/
   sudo chmod a+rx /usr/local/bin/sloctl
   open /usr/local/bin

4. If macOS blocks the binary, right-click sloctl in Finder and select Open.

5. Verify the installation:

   sloctl version

Go

1. Install the latest version of sloctl:

   go install github.com/nobl9/sloctl/cmd/sloctl@latest

2. Confirm that the bin directory under GOPATH is in your system path.

3. If necessary, add the directory for the current shell session:

   export PATH="$PATH:$(go env GOPATH)/bin"

4. Verify the installation:

   sloctl version

Docker

The official sloctl image is available on Docker Hub.

1. Pull the latest image:

   docker pull nobl9/sloctl

2. Verify the image:

   docker run --rm nobl9/sloctl version

To authenticate with environment variables, see Configuring sloctl.

Windows

Prebuilt binary (recommended)

1. Download the appropriate prebuilt binary from the latest sloctl release.

   Choose windows, with arm64 for ARM64 processors or amd64 for Intel/AMD 64-bit processors.

2. Create a Nobl9 directory in one of these locations:

   • For an administrator installation, use C:\Program Files\.
   • For a non-administrator installation, use your user directory.

3. Rename the binary to sloctl.exe.

4. Move sloctl.exe to the Nobl9 directory.

5. For a non-administrator installation, add the directory to the user Path environment variable:

   1. Go to Control Panel > System and Security > System.
   2. Select Advanced System Settings > Environment Variables.
   3. Under User variables, select Path, then select Edit.
   4. Add the directory that contains sloctl.exe, then save your changes.

6. Verify the installation:

   sloctl version

Script (MinGW/Cygwin)

The installation script requires Bash and a minimal set of GNU utilities. On Windows, run it with MinGW or Cygwin.

Run the script with curl:

curl -fsSL https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash | bash

If curl is not available, use wget:

wget -O - -q https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash | bash

To inspect the script before you run it, download it first:

curl -fsSL -o install.bash https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash
chmod 700 install.bash
./install.bash --help

After inspection, run the downloaded script:

./install.bash

Verify the installation:

sloctl version

Go

1. Install the latest version of sloctl:

   go install github.com/nobl9/sloctl/cmd/sloctl@latest

2. Confirm that the bin directory under GOPATH is in your system path.

3. If necessary, add the directory for the current shell session:

   $env:Path += ";$(go env GOPATH)\bin"

4. Verify the installation:

   sloctl version

Docker

The official sloctl image is available on Docker Hub.

1. Pull the latest image:

   docker pull nobl9/sloctl

2. Verify the image:

   docker run --rm nobl9/sloctl version

To authenticate with environment variables, see Configuring sloctl.

Linux

Script (recommended)

The installation script requires Bash and a minimal set of GNU utilities.

Run the script with curl:

curl -fsSL https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash | bash

If curl is not available, use wget:

wget -O - -q https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash | bash

To inspect the script before you run it, download it first:

curl -fsSL -o install.bash https://raw.githubusercontent.com/nobl9/sloctl/main/install.bash
chmod 700 install.bash
./install.bash --help

After inspection, run the downloaded script:

./install.bash

Verify the installation:

sloctl version

Prebuilt binary

1. Download the appropriate prebuilt binary from the latest sloctl release.

   Choose linux, with arm64 for ARM64 processors or amd64 for Intel/AMD 64-bit processors.

2. Rename the binary to sloctl.

3. Grant executable permission and move the binary to a directory in your system path:

   chmod +x sloctl
   sudo mv sloctl /usr/local/bin/sloctl

4. Verify the installation:

   sloctl version

Go

1. Install the latest version of sloctl:

   go install github.com/nobl9/sloctl/cmd/sloctl@latest

2. Confirm that the bin directory under GOPATH is in your system path.

3. If necessary, add the directory for the current shell session:

   export PATH="$PATH:$(go env GOPATH)/bin"

4. Verify the installation:

   sloctl version

Docker

The official sloctl image is available on Docker Hub.

1. Pull the latest image:

   docker pull nobl9/sloctl

2. Verify the image:

   docker run --rm nobl9/sloctl version

To authenticate with environment variables, see Configuring sloctl.