summaryrefslogtreecommitdiffstats
path: root/dashboard/readme.txt
diff options
context:
space:
mode:
Diffstat (limited to 'dashboard/readme.txt')
-rw-r--r--dashboard/readme.txt36
1 files changed, 36 insertions, 0 deletions
diff --git a/dashboard/readme.txt b/dashboard/readme.txt
new file mode 100644
index 0000000..2a25912
--- /dev/null
+++ b/dashboard/readme.txt
@@ -0,0 +1,36 @@
+##############################################################################
+# Copyright (c) 2016 Max Breitenfeldt and others.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Apache License, Version 2.0
+# which accompanies this distribution, and is available at
+# http://www.apache.org/licenses/LICENSE-2.0
+##############################################################################
+
+
+The dashboard is deployed using docker-compose.
+Application / database files are saved in /var/lib/pharos_dashboard/.
+
+Deployment:
+
+- clone the repository
+- complete the config.env.sample file and save it as config.env
+- install docker, docker-compose and bower
+- run 'bower install' in ./src/static/ to fetch javascript dependencies
+- run 'make build' to build the containers
+- run 'make data'
+- run 'make up' to run the dashboard
+
+Updating:
+
+- make stop
+- git pull
+- run 'bower install' if javascript dependencies changed
+- make build
+- make start
+
+If there is migrations that need user input (like renaming a field), they need to be run manually!
+
+Logs / Shell access:
+
+- there is some shortcuts in the makefile