TorresVault Documentation

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== 🐳 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 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](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](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](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](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>

---

Edit summary