Differences

This shows you the differences between two versions of the page.

--- software_installation [2025/12/27 22:40] – created robyn
+++ software_installation [2025/12/29 19:55] (current) – robyn
@@ Line 2: / Line 2: @@
 ==== Software installation ====
+== Presumptions: ==
+  * You have installed Docker and maybe Portainer. The host machine has a fixed IP (Static or DHCP reservation). Note this IP address down \\ \\
+  * You have a working Ollama installation and a suitable LLM pulled. From the CLI (command line interface) in a terminal you may have typed **ollama run llama2-uncensored** which will automatically pull the model and run it. This as well will require a fixed IP.  \\ \\
+== Installation: ==
+  * In your home directory open your Editor of choice, I use nano in linux, NetworkChuck tells me it is the best, BTW to copy code in the block just click on it. <code bash>nano ~/.bashrc</code>, add these two lines:<code bash>
+export PUID=$(id -u)
+export PGID=$(id -g)
+</code>
+  * CNTL X, Y, <enter> to save.
+  * From your home directory, type ''mkdir avadroid'', then, ''cd avadroid''. now, type, ''mkdir <name of your AvaDroid>'', example: "mkdir cath", cd into this directory, example "cd cath" (Without the quotation marks).  \\ \\
+  * You should now be in the directory ''avadroid\<Name>\''  \\ Example avadroid\cath\ \\ \\
+  * Next type ''mkdir bot'' \\ \\
+  * Then with your favourite editor, on linux I use Nano, create to edit a file called "compose.yml" \\ Example ''nano compose.yml'' \\ \\
+  * Cut and Paste the below: <code yaml> services:
+  corrade:
+    image: wizardrysteamworks/corrade
+    container_name: anne-corrade
+    ports:
+      - "19001:54377"
+      - "17001:1883"
+    volumes:
+      - ./corrade:/etc/corrade/
+    environment:
+      - TZ=US/Pacific
+    networks:
+      - anne-net
+    restart: unless-stopped
+  avadroid:
+    image: vk6xre/avadroid:latest
+    container_name: anne-avadroid
+    user: "${PUID}:${PGID}"
+    ports:
+      - "18001:5001"
+    volumes:
+      - ./bot:/app/bot
+    environment:
+      - TZ= US/Pacific
+    networks:
+      - anne-net
+    depends_on:
+      - corrade
+    restart: unless-stopped
+networks:
+  anne-net:
+    driver: bridge
+</code>
+  * We have to edit this file to suit your system. \\
+  * First: Where you see anne replace anne with the name of your AvaDroid, Example if your Avadroid is named "fred" change: \\ \\ container_name: anne-corrade to container_name: fred-corrade \\ container_name: anne-avadroid to container_name: fred-avadroid \\ - anne-net to - fred-net (3 locations) \\ \\
+  * Next: Port redirections. in <code yaml> ports:
+      - "19001:54377"
+      - "17001:1883"
+</code><code yaml>ports:
+      - "18001:5001" </code>
+  * The number to the left is the "exposed port", it is what the outside world sees. Each AvaDroid needs unique port allocations. The number to the right is the internal port allocation, NEVER change this. \\ \\ 54377 is Corrades Nucleus Web interface. \\ 1883 is Corrades MQTT server, this is used for AvaDroid to talk to Corrade. \\ 5001 is AvaDroids Web Gui interface. \\ \\ I have mapped them 19001, 17001 and 18001 respectfully. The next AvaDroid will be 19002, 17002 and 18002. If you are going to have many AvaDroids,it may be a good idea to make a spreadsheet with Name, Nucleus, MQTT, GUI columns to keep track. Of course you can make up your own numbering plan or follow along with mine. \\ \\
+  * Once you are happy with the compose.yml edits, in nano at least, CNTL X, Y, <enter> to save. \\ \\
+  * Next, to create the containers.  \\ \\
+  * Copy and paste ''docker compose up -d'', wait for the images to pull down and the containers to start. \\ \\
+  * At this point the AvaDroid container is failing as Corrade is not configured. You can stop the AvaDroid container with ''docker stop <name>-avadroid''
+Next Step, Configure [[corrade_configure|Corrade]].