Getting Started

• 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.
  
  

• 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.

  nano ~/.bashrc

  , add these two lines:

  export PUID=$(id -u)
  export PGID=$(id -g) 

• 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:

   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

• 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

   ports:
        - "19001:54377"
        - "17001:1883"

  ports:
        - "18001:5001" 

• 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.