Add instructions to add laconic-so download location to PATH

README.md

@@ -38,6 +38,7 @@
 
 ## Playbooks
 
+- [stack-orchestrator-setup](./stack-orchestrator-setup/README.md)
 - [l2-setup](./l2-setup/README.md)
 - [nitro-node-setup](./nitro-nodes-setup/README.md)
 - [nitro-bridge-setup](./nitro-bridge-setup/README.md)

stack-orchestrator-setup/README.md

@@ -2,11 +2,13 @@
 
 ## Setup Ansible
 
-To get started, follow the [installation](../README.md#installation) guide to setup ansible on your machine
+To get started, follow the [installation](../README.md#installation) guide to setup ansible on your machine.
 
 ## Setup Stack Orchestrator
 
-The following commands have to be executed in the [`stack-orchestrator-setup`](./) directory. This playbook will install Docker and Stack Orchestrator on the machine if they aren't already present
+This playbook will install Docker and Stack Orchestrator (laconic-so) on the machine if they aren't already present.
+
+Run the following commands in the [`stack-orchestrator-setup`](./) directory.
 
 ### On Local Host
 
@@ -61,12 +63,31 @@ To run the playbook on a remote host:
 
 ## Verify Installation
 
-- To verify installtion, run the following commands:
+- After the installation is complete, ensure that `$HOME/bin` is added to your `PATH` to access `laconic-so` from anywhere in the terminal. You can do this by running the following command:
+
+  ```bash
+  export PATH="$HOME/bin:$PATH"
+  ```
+
+- To make this change permanent, add the following line to your shell configuration file (`~/.bashrc` or `~/.zshrc`, depending on your shell):
+
+  ```bash
+  # For bash users
+  echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
+
+  # For zsh users
+  echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
+  ```
+
+- Once the PATH is set, verify the installation by running the following commands:
 
   ```bash
   # Check version of docker
   docker --version
 
+  # Check version of docker compose
+  docker compose version
+
   # Check version of Stack Orchestrator
   laconic-so version
   ```

stack-orchestrator-setup/setup-docker.yml

@@ -68,21 +68,22 @@
         state: latest
       notify: Restart Docker
 
-    - name: Verify Docker installation by running the hello world image
-      command: docker run hello-world
-      register: hello_world_output
-      ignore_errors: true
-
-    - name: Display hello-world output
-      debug:
-        var: hello_world_output.stdout_lines
-
     - name: Add user to docker group
       user:
         name: "{{ ansible_user }}"
         groups: docker
         append: true
 
+    - name: Verify Docker installation by running the hello world image
+      command: docker run hello-world
+      register: hello_world_output
+      ignore_errors: true
+      become: no
+
+    - name: Display hello-world output
+      debug:
+        var: hello_world_output.stdout_lines
+
   handlers:
     - name: Restart Docker
       service:

stack-orchestrator-setup/setup-laconic-so.yml

@@ -43,13 +43,6 @@
           mode: '0755'
           force: yes
 
-    - name: Ensure ~/bin is on the PATH in .zshrc
-      lineinfile:
-        path: "{{ ansible_env.HOME }}/.zshrc"
-        regexp: '^export PATH=.*{{ ansible_env.HOME }}/bin'
-        line: 'export PATH="{{ ansible_env.HOME }}/bin:$PATH"'
-        state: present
-
     - name: Ensure ~/.laconic-so directory exists
       file:
         path: "{{ ansible_env.HOME }}/.laconic-so"