diff --git a/docs/source/migrating_to_1.16.rst b/docs/source/migrating_to_1.16.rst
new file mode 100644
index 00000000..6924fb3c
--- /dev/null
+++ b/docs/source/migrating_to_1.16.rst
@@ -0,0 +1,32 @@
+Migrating to Koji 1.16
+======================
+
+..
+  reStructured Text formatted
+
+You should consider the following changes when migrating to 1.16:
+
+DB Updates
+----------
+
+This release has schema changes to support tracking history for hosts.
+
+    * new table: ``host_config``
+    * some fields from the ``host`` table have moved to ``host_config``
+    * the ``host_channels`` table now has versioning data like the other
+      versioned tables
+
+As in previous releases, we provide a migration script that updates the
+database.
+
+::
+
+    # psql koji koji  </usr/share/doc/koji/docs/schema-upgrade-1.15-1.16.sql
+
+
+Other changes
+-------------
+
+There are numerous other changes in 1.16 that should not have a direct impact
+on migration. For details see:
+:doc:`release_notes_1.16`
diff --git a/docs/source/migrations.rst b/docs/source/migrations.rst
index 10ca3a6b..a81546e7 100644
--- a/docs/source/migrations.rst
+++ b/docs/source/migrations.rst
@@ -5,6 +5,7 @@ Migrations
 .. toctree::
     :maxdepth: 1
 
+    migrating_to_1.16
     migrating_to_1.15
     migrating_to_1.14
     migrating_to_1.13
diff --git a/docs/source/release_notes_1.16.rst b/docs/source/release_notes_1.16.rst
index 37cb7dd8..06288e50 100644
--- a/docs/source/release_notes_1.16.rst
+++ b/docs/source/release_notes_1.16.rst
@@ -2,6 +2,13 @@ Koji 1.16.0 Release notes
 =========================
 
 
+Migrating from Koji 1.15
+------------------------
+
+For details on migrating see :doc:`migrating_to_1.16`
+
+
+
 Security Fixes
 --------------