From a96ca1d8f96b37334799325da50df99227936a14 Mon Sep 17 00:00:00 2001
From: zadevhub <138465437+zadevhub@users.noreply.github.com>
Date: Wed, 18 Feb 2026 06:38:45 +0000
Subject: [PATCH] Update install.md - Add PostgreSQL Installation Dependency
I was referring to the SQLModel documentation but using PostgreSQL instead of SQLite.
After a lot of troubleshooting, I identified that I need to additionally install a database driver to work with PostgreSQL as SQLModel does not install a database driver.
Good to add this Tip for new / junior developers.
---
docs/install.md | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/docs/install.md b/docs/install.md
index 129df3512b..c1d6b88f86 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -24,6 +24,21 @@ Python has integrated support for SQLite, it is a single file read and processed
In fact, SQLite is perfectly capable of handling quite big applications. At some point you might want to migrate to a server-based database like PostgreSQL (which is also free). But for now we'll stick to SQLite.
+/// info
+
+In case you're using PostgreSQL, SQLModel does not install a database driver (such as Psycopg) and you'll need to install a database driver yourself.
+
+To install psycopg v3, run the following commands:
+
+pip install --upgrade pip
+pip install "psycopg[binary]"
+
+This installs the binary version (recommended for most users)
+
+For other installation options, see the Psycopg documentation.
+
+///
+
Through the tutorial I will show you SQL fragments, and Python examples. And I hope (and expect 🧐) you to actually run them, and verify that the database is working as expected and showing you the same data.
To be able to explore the SQLite file yourself, independent of Python code (and probably at the same time), I recommend you use DB Browser for SQLite.