CLI: add complete instructions for linux (#114)

Author: nicoloboschi

SUMMARY.md

@@ -15,10 +15,10 @@
 
 ## installation
 
+* [LangStream CLI](installation/langstream-cli.md)
+* [Docker](installation/docker.md)
 * [Minikube (mini-langstream)](installation/get-started-minikube.md)
 * [Kubernetes](installation/kubernetes.md)
-* [Docker](installation/docker.md)
-* [LangStream CLI](installation/langstream-cli.md)
 * [Build and install from source](installation/build-and-install-source.md)
 
 ## Building Applications

installation/langstream-cli.md

@@ -1,29 +1,59 @@
 # LangStream CLI
 
-Use the CLI to manage your control plane, deploy applications, and interact with an application's gateway.
+Use the CLI to test, verify and deploy applications.
 
 For LangStream CLI commands, see [CLI commands.](../langstream-cli/langstream-cli-commands.md)
-
 To configure the LangStream CLI, see [CLI configuration.](../langstream-cli/langstream-cli-configuration.md)
 
-## Download the CLI
+## Installation
 
 ### Mac
 
+Install the latest version
+
 ```bash
 brew install LangStream/langstream/langstream
 ```
 
+Install a specific version
+```bash
+brew install LangStream/langstream/[email protected]
+```
+
+To upgrade
+```bash
+brew upgrade LangStream/langstream/langstream
+```
+
+To upgrade to a specific version
+```bash
+brew upgrade LangStream/langstream/[email protected]
+```
+
 ### Linux
 
+Install the latest version
+
+```bash
+curl -Ls "https://raw.githubusercontent.com/LangStream/langstream/main/bin/get-cli.sh" | bash
+```
+
+Install a specific version
 ```bash
+version=x.y.z
+export LANGSTREAM_CLI_URL="https://github.com/LangStream/langstream/releases/download/v$version/langstream-cli-$version.zip"
 curl -Ls "https://raw.githubusercontent.com/LangStream/langstream/main/bin/get-cli.sh" | bash
 ```
 
+To upgrade the CLI version, you can run the installer again.
+
 ### Windows
 
 Use [WSL](https://learn.microsoft.com/en-us/windows/wsl/about).
 
+Alternatively, you can run the `.bat` file present inside the CLI tarball. You can download the tarball from [Github Releases](https://github.com/LangStream/langstream/releases)
+
+
 {% hint style="info" %}
 Want to get started a little quicker? Check out the [LangStream VSCode Extension](https://marketplace.visualstudio.com/items?itemName=DataStax.langstream) for pre-made applications and agent code snippets.
 {% endhint %}
@@ -54,3 +84,35 @@ source $HOME/.zshrc # or open another terminal
 [[ $(grep 'langstream generate-completion' "$HOME/.bashrc") ]] || echo -e "source <(langstream generate-completion)" >> "$HOME/.bashrc"
 source $HOME/.bashrc # or open another terminal
 ```
+
+
+
+### Step by step guide on Amazon Linux VM
+
+If for some reasons you prefer to install the CLI and test the applications on a remote machine, this is setup you need to go through.
+
+After creating the VM on [EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html), you can run the following commands:
+
+```bash
+sudo yum update
+# jq, unzip are for the installer
+sudo yum install -y docker jq unzip java-11-amazon-corretto-headless
+# setup docker
+
+sudo usermod -a -G docker ec2-user
+id ec2-user
+newgrp docker
+sudo systemctl enable docker.service
+sudo systemctl start docker.service
+
+# download the CLI
+curl -Ls "https://raw.githubusercontent.com/LangStream/langstream/main/bin/get-cli.sh" | bash
+source ~/.bashrc
+
+# run the sample application
+export OPEN_AI_ACCESS_KEY=your-key-here
+langstream docker run test -app https://github.com/LangStream/langstream/blob/main/examples/applications/openai-completions -s https://github.com/LangStream/langstream/blob/main/examples/secrets/secrets.yaml
+```
+
+
+