diff --git a/README.md b/README.md
new file mode 100644
index 0000000..81d0b76
--- /dev/null
+++ b/README.md
@@ -0,0 +1,84 @@
+# Firefox ESR für Ubuntu (APT statt Snap)
+
+Dieses Repository enthält ein Bash-Skript, um **Firefox als Snap-Anwendung dauerhaft zu entfernen** und stattdessen **Firefox ESR als klassisches APT-Paket** zu installieren. Das Skript stellt sicher, dass Firefox nicht wieder als Snap installiert wird und die deutsche Sprachunterstützung enthält.
+
+---
+
+## Warum dieses Skript?
+
+Ab Ubuntu 22.04 LTS wird Firefox standardmäßig als **Snap-Anwendung** installiert. Viele Nutzer bevorzugen jedoch die klassische **APT-Installation** aus folgenden Gründen:
+- Bessere Integration ins System
+- Schnellere Startzeit
+- Keine Snap-Sandbox-Einschränkungen
+- Einfacheres Update-Management
+
+---
+
+## Was macht das Skript?
+
+1. **Entfernt Firefox als Snap-Anwendung** (`snap remove --purge firefox`).
+2. **Verhindert die erneute Installation von Firefox als Snap** durch eine APT-Präferenzdatei.
+3. **Installiert Firefox ESR als APT-Paket** (`firefox-esr`).
+4. **Fügt die deutsche Sprachunterstützung hinzu** (`firefox-esr-locale-de`).
+5. **Setzt Firefox ESR als Standardbrowser** (optional).
+
+---
+
+## Voraussetzungen
+
+- Ubuntu 22.04 LTS oder neuer
+- Terminalzugriff mit `sudo`-Rechten
+
+---
+
+## Installation
+
+### 1. Repository klonen
+```bash
+git clone https://dein-gitea-server.de/dein-benutzername/firefox-esr-apt.git
+cd firefox-esr-apt
+```
+
+### 2. Skript ausführbar machen
+```bash
+chmod +x firefox_fix.sh
+```
+
+### 3. Skript ausführen
+```bash
+./firefox_fix.sh
+```
+
+---
+
+## Manuelle Ausführung (ohne Git)
+
+Falls du das Skript nicht klonen möchtest, kannst du es auch direkt herunterladen und ausführen:
+
+```bash
+wget https://dein-gitea-server.de/dein-benutzername/firefox-esr-apt/raw/branch/master/firefox_fix.sh
+chmod +x firefox_fix.sh
+./firefox_fix.sh
+```
+
+---
+
+## Wichtige Hinweise
+
+- **Firefox ESR** ist die **Extended Support Release** und erhält weniger häufige Updates als die Standardversion. Sie ist stabiler, aber nicht immer auf dem neuesten Stand.
+- Falls du die **neueste Firefox-Version** möchtest, kannst du stattdessen das [offizielle Mozilla PPA](https://launchpad.net/~mozillateam/+archive/ubuntu/ppa) verwenden. Das Skript kann entsprechend angepasst werden.
+- Das Skript setzt Firefox ESR als Standardbrowser. Falls du das nicht möchtest, entferne die letzten beiden Zeilen im Skript.
+
+---
+
+## Lizenz
+
+Dieses Skript steht unter der [MIT-Lizenz](LICENSE). Du kannst es frei verwenden, ändern und weitergeben.
+
+---
+
+## Feedback und Beiträge
+
+Falls du Fragen, Verbesserungsvorschläge oder Probleme hast, öffne bitte ein [Issue](https://dein-gitea-server.de/dein-benutzername/firefox-esr-apt/issues) oder erstelle einen Pull Request.
+
+Viel Erfolg mit Firefox ESR! 🦊