From 2d772351c151ed984719555f52bbc5924585ea98 Mon Sep 17 00:00:00 2001
From: Brian Olson <brian@hurrikane.net>
Date: Wed, 31 Dec 2025 20:44:58 -0500
Subject: [PATCH] docs: add system requirements to README

Add detailed system requirements including:
- Minimum specs for building (2 cores, 2GB RAM)
- Runtime-only specs for pre-built images (1 core, 512MB)
- Recommended production specs (2+ cores, 2GB RAM)
- Note about memory requirements for Docker build

Fixes #132
---
 README.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 68afa4d..880b30d 100644
--- a/README.md
+++ b/README.md
@@ -16,9 +16,41 @@ Tabby Web serves the [Tabby Terminal](https://github.com/Eugeny/tabby) as a web
 
 # Requirements
 
-* Python 3.7+
+## Software Requirements
+
+* Python 3.10+ (3.12 recommended)
+* Node.js 18+ (for frontend build)
 * A database server supported by Django (MariaDB, Postgres, SQLite, etc.)
 * Storage for distribution files - local, S3, GCS or others supported by `fsspec`
+* Docker and Docker Compose (for containerized deployment)
+
+## System Requirements
+
+### Minimum (Build & Run)
+
+| Resource | Requirement |
+|----------|-------------|
+| CPU | 2 cores |
+| RAM | 2GB (4GB recommended for building) |
+| Disk | 5GB |
+
+> **Note:** Building the Docker image requires significant memory for the frontend compilation step. If you're running on a memory-constrained system (like Oracle Cloud Free Tier), consider using a pre-built image or building on a machine with more RAM.
+
+### Runtime Only (Pre-built Image)
+
+| Resource | Requirement |
+|----------|-------------|
+| CPU | 1 core |
+| RAM | 512MB |
+| Disk | 1GB + app distributions |
+
+### Recommended (Production)
+
+| Resource | Requirement |
+|----------|-------------|
+| CPU | 2+ cores |
+| RAM | 2GB |
+| Disk | 10GB |
 
 # Quickstart (using `docker-compose`)