diff --git a/.env.example b/.env.example
index e791c9b..f576756 100644
--- a/.env.example
+++ b/.env.example
@@ -1,8 +1,20 @@
-# ── Database (Postgres) ──────────────────────────────────────────────────────
+# ── PostgreSQL Database Settings ─────────────────────────────────────────────
 DB_USER=postgres
-DB_PASS=supersecret
-DB_NAME=lnbitsdb
-DATABASE_URL=postgresql://${DB_USER}:${DB_PASS}@db:5432/${DB_NAME}
+#   The username your bot will use to connect to Postgres.
+#   Default Postgres user is “postgres”, but you can lock it down.
 
-# ── Flask UI ──────────────────────────────────────────────────────────────────
+DB_PASS=supersecret
+#   The password for that DB_USER. Keep this strong and secret.
+
+DB_NAME=lnbitsdb
+#   The name of the database that holds your `config`, `plans`, and `subscriptions` tables.
+#   On first run the `lnbitsdb` DB will be created automatically by the Postgres container.
+
+DATABASE_URL=postgresql://${DB_USER}:${DB_PASS}@db:5432/${DB_NAME}
+#   The full SQLAlchemy connection string your bot uses to open the database.
+#   NOTE: “db” here is the service name from docker-compose, not “localhost”.
+
+# ── Flask Web UI Settings ────────────────────────────────────────────────────
 FLASK_SECRET=someRandomStringForSessions
+#   A random string (32+ chars) used by Flask to sign session cookies.
+#   Change this to something unguessable before going into production.
\ No newline at end of file