commit d0c0c1188139cd32e316fb54d6aa39597f4135c6
Author: Otto <otto@ledrew.me>
Date:   Sat Mar 28 19:58:42 2026 +0000

    Initial commit: Docker and Docker Compose installation guide

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bf52a0f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,80 @@
+# Docker and Docker Compose Installation Guide
+
+Guide to installing Docker and Docker Compose on Ubuntu 24.04.
+
+## Install Docker
+
+```bash
+# Update packages
+sudo apt update
+
+# Install Docker
+sudo apt install -y docker.io
+
+# Start Docker
+sudo systemctl start docker
+sudo systemctl enable docker
+
+# Add current user to docker group (log out/in after)
+sudo usermod -aG docker $USER
+```
+
+## Install Docker Compose
+
+```bash
+sudo apt install -y docker-compose
+```
+
+## Verify Installation
+
+```bash
+docker --version
+docker-compose --version
+```
+
+## Troubleshooting
+
+### Docker won't start
+```bash
+sudo systemctl status docker
+sudo systemctl restart docker
+```
+
+### Permission denied errors
+Make sure you're in the docker group:
+```bash
+groups $USER
+```
+
+If not, run:
+```bash
+sudo usermod -aG docker $USER
+# Then log out and back in
+```
+
+## Basic Docker Commands
+
+```bash
+# List running containers
+docker ps
+
+# List all containers
+docker ps -a
+
+# Stop a container
+docker stop <container-name>
+
+# Remove a container
+docker rm <container-name>
+
+# View logs
+docker logs <container-name>
+
+# Build and run with docker-compose
+docker-compose up -d --build
+```
+
+## Useful Links
+
+- [Docker Official Docs](https://docs.docker.com/)
+- [Docker Compose Docs](https://docs.docker.com/compose/)