diff --git a/lib/xos-config/xosconfig/xos-config-schema.yaml b/lib/xos-config/xosconfig/xos-config-schema.yaml
new file mode 100644
index 0000000..a2b2c75
--- /dev/null
+++ b/lib/xos-config/xosconfig/xos-config-schema.yaml
@@ -0,0 +1,33 @@
+map:
+  name:
+    type: str
+    required: True
+  xos_dir:
+    type: str
+  database:
+    type: map
+    map:
+      name:
+        type: str
+        required: True
+      username:
+        type: str
+        required: True
+      password:
+        type: str
+        required: True
+  logging:
+    type: map
+    map:
+      logstash_hostport:
+        type: str
+      level:
+        type: str
+        # TODO add validation [info, debug, warning, error, critical]
+      channels:
+        type: seq
+        sequence:
+          - type: str
+            enum: ['file', 'console', 'elkstack']
+  xos_dir:
+    type: str
\ No newline at end of file