From 5fb0a6dffee8a8a7a41dccdc8aff8b67fb0a0a1a Mon Sep 17 00:00:00 2001
From: Carol Willing <carolcode@willingconsulting.com>
Date: Mon, 7 Nov 2016 16:16:24 -0800
Subject: [PATCH] Add note on databases

---
 docs/source/upgrading.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/source/upgrading.md b/docs/source/upgrading.md
index 4b765c4d..2e8201e1 100644
--- a/docs/source/upgrading.md
+++ b/docs/source/upgrading.md
@@ -47,3 +47,12 @@ To run the upgrade process for JupyterHub databases, enter:
 ```
 jupyterhub upgrade-db
 ```
+
+## A note about JupyterHub databases
+
+The default database for JupyterHub is a sqlite database. sqlite is useful for
+testing, small deployments, and workshops.
+
+When running a long term deployment or a production system, we recommend using
+a database that supports ALTER_TABLE, such as Postgres or MySQL, as it will
+simplify future upgrades that may change database fields.