diff --git a/ansible/roles/ceph/tasks/main.yml b/ansible/roles/ceph/tasks/main.yml
index bc5d1e62576375cb42a2a0d62540aa54d212db7c..ab2a7dcfb6916b5d4665d9e4583f0afffc3019a9 100644
--- a/ansible/roles/ceph/tasks/main.yml
+++ b/ansible/roles/ceph/tasks/main.yml
@@ -1,2 +1,14 @@
 ---
+- name: Warn about deprecation
+  debug:
+    msg: >-
+      Support for deploying Ceph via Kolla Ansible is deprecated. In a future
+      release support for deploying Ceph will be removed from Kolla Ansible. Prior
+      to this we will ensure a migration path to another tool such as Ceph
+      Ansible (http://docs.ceph.com/ceph-ansible/master/>) is available. For new
+      deployments it is recommended to use another tool to deploy Ceph to avoid a
+      future migration. This can be integrated with OpenStack by following the
+      external Ceph guide
+      (https://docs.openstack.org/kolla-ansible/latest/reference/storage/external-ceph-guide.html).
+
 - include_tasks: "{{ kolla_action }}.yml"
diff --git a/doc/source/reference/storage/ceph-guide.rst b/doc/source/reference/storage/ceph-guide.rst
index 53722674d255fabd7f0cd5802ef7132e5d9b8ee6..c538a6fdd9068bfe7796d98f7450e6b0c126694e 100644
--- a/doc/source/reference/storage/ceph-guide.rst
+++ b/doc/source/reference/storage/ceph-guide.rst
@@ -1,8 +1,17 @@
 .. _ceph-guide:
 
-===============================
-Ceph - Software Defined Storage
-===============================
+============================================
+Ceph - Software Defined Storage (Deprecated)
+============================================
+
+.. warning::
+   Support for deploying Ceph via Kolla Ansible is deprecated. In a future
+   release support for deploying Ceph will be removed from Kolla Ansible. Prior
+   to this we will ensure a migration path to another tool such as `Ceph
+   Ansible <http://docs.ceph.com/ceph-ansible/master/>`__ is available. For new
+   deployments it is recommended to use another tool to deploy Ceph to avoid a
+   future migration. This can be integrated with OpenStack by following
+   :doc:`external-ceph-guide`.
 
 .. note::
    The out-of-the-box Ceph deployment requires 3 hosts with at least one block
diff --git a/releasenotes/notes/deprecate-ceph-4745da91c7ca5a8e.yaml b/releasenotes/notes/deprecate-ceph-4745da91c7ca5a8e.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..b1550adf38857746c760c170a8b117d8f1bf9835
--- /dev/null
+++ b/releasenotes/notes/deprecate-ceph-4745da91c7ca5a8e.yaml
@@ -0,0 +1,11 @@
+---
+deprecations:
+  - |
+    Deprecates support for deploying Ceph. In a future release support for
+    deploying Ceph will be removed from Kolla Ansible. Prior to this we will
+    ensure a migration path to another tool such as `Ceph Ansible
+    <http://docs.ceph.com/ceph-ansible/master/>`__ is available. For new
+    deployments it is recommended to use another tool to deploy Ceph to avoid a
+    future migration. This can be integrated with OpenStack by following the
+    `external Ceph guide
+    <https://docs.openstack.org/kolla-ansible/latest/reference/storage/external-ceph-guide.html>`__.