From 1976df01127924a39c7787c1f6ef89d5d57b4e8c Mon Sep 17 00:00:00 2001 From: Shyam Sunder Date: Wed, 3 Jun 2020 09:35:55 -0400 Subject: [PATCH] Updated Troubleshooting (asciidoc) --- Common-errors.asciidoc | 9 +++++++++ Troubleshooting.asciidoc | 19 ------------------- 2 files changed, 9 insertions(+), 19 deletions(-) create mode 100644 Common-errors.asciidoc delete mode 100644 Troubleshooting.asciidoc diff --git a/Common-errors.asciidoc b/Common-errors.asciidoc new file mode 100644 index 0000000..7c59597 --- /dev/null +++ b/Common-errors.asciidoc @@ -0,0 +1,9 @@ +# I have an error with my filesystem permissions + +If you see a message such as the following: + +``` +Cannot start service sql: b"error while creating mount source path '/var/local/szurubooru/sql': mkdir /var/local/szurubooru: read-only file system" +``` + +then you should ensure that the mountpoint for the data directory ($MOUNT_DATA in .env) is owned by UID/GID 1000:1000, but you need to do this on the host machine, not inside the container (Example: `chmod -R 1000:1000 /var/local/szurubooru` if your mountpoint is `/var/local/szurubooru`) \ No newline at end of file diff --git a/Troubleshooting.asciidoc b/Troubleshooting.asciidoc deleted file mode 100644 index 06ea404..0000000 --- a/Troubleshooting.asciidoc +++ /dev/null @@ -1,19 +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 - -# "Could not fetch basic configuration from server.": - -ElasticSearch is failing to initialise, ensure vm.max_map_count parameter for ElasticSearch is changed, https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html#_set_vm_max_map_count_to_at_least_262144[Click here for instructions] -