From 277b5fb465552aa69fac2445e5257d39b3b8540a Mon Sep 17 00:00:00 2001
From: Prathamesh Musale <prathamesh.musale0@gmail.com>
Date: Wed, 19 Jun 2024 17:43:34 +0530
Subject: [PATCH] Add laconic-console stack instructions

---
 .../docker-compose-laconic-console.yml        |  6 +++
 .../stacks/laconic-console/README.md          | 53 +++++++++++++++++++
 2 files changed, 59 insertions(+)

diff --git a/stack-orchestrator/compose/docker-compose-laconic-console.yml b/stack-orchestrator/compose/docker-compose-laconic-console.yml
index 8cde253..b4f2ff0 100644
--- a/stack-orchestrator/compose/docker-compose-laconic-console.yml
+++ b/stack-orchestrator/compose/docker-compose-laconic-console.yml
@@ -8,3 +8,9 @@ services:
       CERC_LOGLEVEL: ${CERC_LOGLEVEL:-info}
     volumes:
       - ../config/laconic-console/create-config.sh:/app/create-config.sh
+      - laconic-registry-data:/laconic-registry-data
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+
+volumes:
+  laconic-registry-data:
diff --git a/stack-orchestrator/stacks/laconic-console/README.md b/stack-orchestrator/stacks/laconic-console/README.md
index 00e0cf7..0e42463 100644
--- a/stack-orchestrator/stacks/laconic-console/README.md
+++ b/stack-orchestrator/stacks/laconic-console/README.md
@@ -1 +1,54 @@
 # laconic-console
+
+Instructions for running laconic registry CLI and console
+
+## Prerequisites
+
+* laconicd RPC and GQL endpoints
+
+## Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console setup-repositories
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console build-containers
+  ```
+
+  This should create the following docker images locally:
+
+  * `cerc/laconic2-registry-cli`
+
+## Create a deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy init --output laconic-console-spec.yml
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy create --spec-file  laconic-console-spec.yml --deployment-dir laconic-console-deployment
+  ```
+
+## Configuration
+
+* Inside the deployment directory, open `config.env` file and set following env variables:
+
+  ```bash
+  # TODO
+  ```
+