====== 🐳 Docker & Docker Compose Setup Guide for a Fresh Ubuntu VM ======
This page is designed for your TorresVault wiki. It provides a clean, repeatable checklist and command reference for preparing any new Ubuntu Server VM before deploying an app. This is the **standard baseline** you use across all your VMs.

---

===== ✅ 1. Update & Upgrade the System =====
These commands ensure the VM is fully patched before installing anything.

<code bash>
sudo apt update && sudo apt upgrade -y
sudo apt autoremove -y
sudo reboot
</code>

---

===== 🐋 2. Install Docker =====
The recommended officially supported installation method.

<code bash>
# Remove old versions (optional)
sudo apt remove -y docker docker-engine docker.io containerd runc

# Install dependencies
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

# Add Docker’s official GPG key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Add Docker repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</code>

==== Enable & Start Docker ====
<code bash>
sudo systemctl enable docker
sudo systemctl start docker
</code>

---

===== 👤 3. Add Your User to the docker Group =====
This lets you run Docker without sudo.

<code bash>
sudo usermod -aG docker $USER
newgrp docker
</code>

---

===== 📦 4. Install Standalone Docker Compose (Optional) =====
For apps needing legacy docker-compose v1.

<code bash>
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
</code>

Verify:
<code bash>
docker-compose --version
</code>

---

===== 📁 5. Create App Directory Structure =====
Standard layout for TorresVault app VMs.

<code bash>
mkdir -p ~/apps/<app_name>/data
mkdir -p ~/apps/<app_name>/config
cd ~/apps/<app_name>
</code>

---

===== 🧱 6. Create a Standard docker-compose.yml =====
Template to reuse for each app.

<code yaml>
version: "3.9"
services:
  app:
    image: <image>
    container_name: <app_name>
    restart: unless-stopped
    ports:
      - "PORT:PORT"
    volumes:
      - ./config:/config
      - ./data:/data
    environment:
      - TZ=America/New_York
</code>

---

===== ▶️ 7. Start Containers =====
Using Docker Compose v2:
<code bash>
docker compose up -d
</code>

Using docker-compose v1:
<code bash>
docker-compose up -d
</code>

---

===== 📌 8. Useful Docker Commands =====
**View running containers:**
<code bash>
docker ps
</code>

**View logs:**
<code bash>
docker logs -f <container_name>
</code>

**Restart container:**
<code bash>
docker restart <container_name>
</code>

**Stop all containers:**
<code bash>
docker stop $(docker ps -q)
</code>

**Remove all stopped containers:**
<code bash>
docker container prune
</code>

---

===== 🛠️ 9. Useful Docker Compose Commands =====
**Recreate after editing docker-compose.yml:**
<code bash>
docker compose down && docker compose up -d
</code>

**Validate syntax:**
<code bash>
docker compose config
</code>

---

===== 🔄 10. Full Quick Setup (Copy/Paste) =====
Use this block for rapid setup on every new VM.

<code bash>
sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

sudo apt install -y ca-certificates curl gnupg lsb-release
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo systemctl enable docker
sudo systemctl start docker

sudo usermod -aG docker $USER
newgrp docker
</code>