diff --git a/Troubleshooting.asciidoc b/Troubleshooting.asciidoc
new file mode 100644
index 0000000..edf4306
--- /dev/null
+++ b/Troubleshooting.asciidoc
@@ -0,0 +1,17 @@
+# Permissions error:
+
+ ➜  szuru git:(master) docker-compose up -d
+ Starting szuru_elasticsearch_1 ... 
+ Starting szuru_sql_1           ... error
+ Starting szuru_elasticsearch_1 ... done
+ ERROR: for szuru_sql_1  Cannot start service sql: b"error while creating mount source path '/var/local/szurubooru/sql': mkdir /var/local/szurubooru: read-only file system"
+ ERROR: for sql  Cannot start service sql: b"error while creating mount source path '/var/local/szurubooru/sql': mkdir /var/local/szurubooru: read-only file system"
+ ERROR: Encountered errors while bringing up the project.
+ ➜  szuru git:(master) 
+
+**chown -R 1000:1000 the mountpoint for the data directory ($MOUNT_DATA in .env), but you need to do this on the host machine, not inside the container**
+
+eg. chmod -R 1000:1000 /var/local/szurubooru
+
+
+
diff --git a/Troubleshooting.md b/Troubleshooting.md
deleted file mode 100644
index f00190a..0000000
--- a/Troubleshooting.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Permissions error:
-
-> ➜  szuru git:(master) docker-compose up -d
-> Starting szuru_elasticsearch_1 ... 
-> Starting szuru_sql_1           ... error
-> Starting szuru_elasticsearch_1 ... done
-> ERROR: for szuru_sql_1  Cannot start service sql: b"error while creating mount source path '/var/local/szurubooru/sql': mkdir /var/local/szurubooru: read-only file system"
-
-> ERROR: for sql  Cannot start service sql: b"error while creating mount source path '/var/local/szurubooru/sql': mkdir /var/local/szurubooru: read-only file system"
-> ERROR: Encountered errors while bringing up the project.
-> ➜  szuru git:(master) 
-
-**chown -R 1000:1000 the mountpoint for the data directory ($MOUNT_DATA in .env), but you need to do this on the host machine, not inside the container**
-
-eg. chmod -R 1000:1000 /var/local/szurubooru
-
-
-