diff --git a/sysadm/deployment/data-migration.rst b/sysadm/deployment/data-migration.rst
new file mode 100644
index 0000000..e1624bb
--- /dev/null
+++ b/sysadm/deployment/data-migration.rst
@@ -0,0 +1,9 @@
+.. _data-migration:
+
+How to handle data migrations
+=============================
+
+
+
+
+
diff --git a/sysadm/deployment/deploy-lister.rst b/sysadm/deployment/deploy-lister.rst
new file mode 100644
index 0000000..a220726
--- /dev/null
+++ b/sysadm/deployment/deploy-lister.rst
@@ -0,0 +1,9 @@
+.. _deploy-new-lister:
+
+How to deploy a new lister
+==========================
+
+
+
+
+
diff --git a/sysadm/deployment/index.rst b/sysadm/deployment/index.rst
new file mode 100644
index 0000000..cd19c63
--- /dev/null
+++ b/sysadm/deployment/index.rst
@@ -0,0 +1,11 @@
+SWH Software Deployment
+-----------------------
+
+.. toctree::
+   :titlesonly:
+
+  software-deployment-overview
+  upgrade-swh-service
+  deploy-lister
+  data-migration
+
diff --git a/sysadm/deployment/software-deployment-overview.rst b/sysadm/deployment/software-deployment-overview.rst
new file mode 100644
index 0000000..0af677e
--- /dev/null
+++ b/sysadm/deployment/software-deployment-overview.rst
@@ -0,0 +1,9 @@
+.. _software-deployment-overview:
+
+Software Deployment Overview
+============================
+
+
+
+
+
diff --git a/sysadm/deployment/upgrade-swh-service.rst b/sysadm/deployment/upgrade-swh-service.rst
new file mode 100644
index 0000000..179eb4e
--- /dev/null
+++ b/sysadm/deployment/upgrade-swh-service.rst
@@ -0,0 +1,9 @@
+.. _upgrade-swh-service
+
+How to upgrade swh service
+==========================
+
+
+
+
+