diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..2e0a22a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.cache/
+venv/
+env/
+ENV/
+.env
+.venv
+.pytest_cache/
+instance/
+/.vscode/
+.DS_Store
+grepo.db
+data/
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..f7a1107
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,20 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+# Install minimal deps for pip encryption/ssl if needed
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+ && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 5050
+
+CMD ["python", "app.py"]
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..e05a1ad
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,13 @@
+version: '3.8'
+
+services:
+  web:
+    build: .
+    ports:
+      - '5050:5050'
+    volumes:
+      - ./:/app:rw
+      - ./data/grepo.db:/app/grepo.db
+    environment:
+      - PYTHONUNBUFFERED=1
+    restart: unless-stopped