Merge pull request #5287 from johnoliver/master

Add docs for fixing read only file system deployments
quarkusio · Nov 13, 2019 · 4d11d49 · 4d11d49
2 parents 776b47a + 7db8dea
commit 4d11d49
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/docs/src/main/asciidoc/vertx.adoc b/docs/src/main/asciidoc/vertx.adoc
@@ -468,6 +468,16 @@ Then, create the native executable with:
 ./mvnw package -Pnative
 ----
 
+== Read only deployment environments
+
+In environments with read only file systems you may receive errors of the form:
+
+```
+java.lang.IllegalStateException: Failed to create cache dir
+```
+
+Assuming `/tmp/` is writeable this can be fixed by setting the `vertx.cacheDirBase` property to point to a directory in `/tmp/` for instance in OpenShift by creating an environment variable `JAVA_OPTS` with the value `-Dvertx.cacheDirBase=/tmp/vertx`.
+
 == Going further
 
 There are many other facets of Quarkus using Vert.x underneath: