diff --git a/README.md b/README.md
index dd1037f..01aca28 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
 # docker
 
-Docker deployment files
\ No newline at end of file
+## swarm.compose
+
+The `swarm.compose` file is used for deploying OwlBoard to a Docker Swarm environment.
+
+Environment variable substitutions need to be configured before deployment - the owlboard.info deployment uses Portainer.
\ No newline at end of file
diff --git a/swarm.compose b/swarm.compose
new file mode 100644
index 0000000..34591fe
--- /dev/null
+++ b/swarm.compose
@@ -0,0 +1,77 @@
+version: '3.7'
+
+services:
+  frontend:
+    image: git.fjla.uk/owlboard/owlboardsvelte:2024.07.4
+    ports:
+      - "8077:80"
+    deploy:
+      replicas: 1
+      update_config:
+        parallelism: 1
+        delay: 30s
+        order: start-first
+        failure_action: rollback
+        monitor: 60s
+      restart_policy:
+        condition: any
+
+  docs:
+    image: git.fjla.uk/owlboard/docs:latest
+    ports:
+      - "8070:80"
+    deploy:
+      replicas: 1
+      update_config:
+        parallelism: 1
+        delay: 30s
+        order: start-first
+        failure_action: rollback
+        monitor: 60s
+      restart_policy:
+        condition: any
+
+  timetable-mgr:
+    image: git.fjla.uk/owlboard/timetablemgr:2024.06.0
+    deploy:
+      replicas: 1
+      update_config:
+        parallelism: 1
+        delay: 60s
+        order: stop-first
+        failure_action: rollback
+        monitor: 60s
+      rollback_config:
+        parallelism: 1
+        delay: 60s
+        order: stop-first
+      restart_policy:
+        condition: any
+    environment:
+      OWL_DB_USER: ${OWL_DB_USER}
+      OWL_DB_PASS: ${OWL_DB_PASS}
+      OWL_DB_HOST: ${OWL_DB_HOST}
+      OWL_DB_PORT: ${OWL_DB_PORT}
+      OWL_NROD_USER: ${OWL_NROD_USER}
+      OWL_NROD_PASS: ${OWL_NROD_PASS}
+
+  backend:
+    image:
+    deploy:
+      replicas: 1
+      update_config:
+        parallelism: 2
+        delay: 60s
+        order: start-first
+        failure_action: rollback
+        monitor: 60s
+      restart_policy:
+        condition: any
+    environment:
+      OWL_DB_USER: ${OWL_DB_USER}
+      OWL_DB_PASS: ${OWL_DB_PASS}
+      OWL_DB_HOST: ${OWL_DB_HOST}
+      OWL_DB_PORT: ${OWL_DB_PORT}
+      OWL_NROD_USER: ${OWL_NROD_USER}
+      OWL_NROD_PASS: ${OWL_NROD_PASS}
+      ... MORE VARIABLES HERE
\ No newline at end of file