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>

---

If you’d like, I can also create a Portainer guide, Kubernetes migration steps, or a TorresVault VM baseline page. & 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.

```bash
sudo apt update && sudo apt upgrade -y
sudo apt autoremove -y
sudo reboot
```

---

## 🐋 2. Install Docker

The recommended officially supported installation method.

```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 | 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
```

### Enable & Start Docker

```bash
sudo systemctl enable docker
sudo systemctl start docker
```

---

## 👤 3. Add Your User to the `docker` Group

This lets you run Docker without `sudo`.

```bash
sudo usermod -aG docker $USER
newgrp docker
```

---

## 📦 4. Install Standalone Docker Compose (Optional)

Ubuntu now includes **Docker Compose v2**, but for apps needing older v1 (`docker-compose`) you can install manually.

```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
```

Verify:

```bash
docker-compose --version
```

---

## 📁 5. Create App Directory Structure

Standard layout for TorresVault app VMs.

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

---

## 🧱 6. Create a Standard `docker-compose.yml`

Template to reuse for each app.

```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
```

---

## ▶️ 7. Start Containers

Using Docker Compose v2:

```bash
docker compose up -d
```

Using standalone v1:

```bash
docker-compose up -d
```

---

## 📌 8. Useful Docker Commands

### View running containers:

```bash
docker ps
```

### View logs:

```bash
docker logs -f <container_name>
```

### Restart container:

```bash
docker restart <container_name>
```

### Stop all containers:

```bash
docker stop $(docker ps -q)
```

### Remove all stopped containers:

```bash
docker container prune
```

---

## 🛠️ 9. Useful Docker Compose Commands

### Recreate containers after editing `docker-compose.yml`:

```bash
docker compose down && docker compose up -d
```

### Validate syntax:

```bash
docker compose config
```

---

## 🔄 10. Full Quick Setup (Copy/Paste)

Use this block for rapid setup on every new VM.

```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
```

---

If you'd like, I can also create:

* A printable PDF version
* A second page for **Portainer setup**
* A TorresVault “standard VM template” page

Edit summary