From b1c4a9538c15f4a6b9c4629ae9936f4415b22853 Mon Sep 17 00:00:00 2001
From: j <j@mailb.org>
Date: Sun, 14 Jul 2019 12:57:31 +0000
Subject: [PATCH] Update page 'Configuration'

---
 Configuration.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 Configuration.md

diff --git a/Configuration.md b/Configuration.md
new file mode 100644
index 0000000..0d519dc
--- /dev/null
+++ b/Configuration.md
@@ -0,0 +1,58 @@
+# Pan.do/ra configuration
+
+## settings_local.py
+located at /srv/pandora/pandora/local_settings.py
+* your database connection, i.e.:
+
+    DATABASES = {
+        'default': {
+            'NAME': 'pandora',
+            'ENGINE': 'django.db.backends.postgresql_psycopg2',
+            'USER': '',
+            'PASSWORD': '',
+        }
+    }
+* celery settings
+
+    BROKER_PORT = 5672
+    BROKER_USER = "pandora"
+    BROKER_PASSWORD = ""
+    BROKER_VHOST = "/pandora"
+* location of site.jsonc
+
+    SITE_CONFIG = '/srv/pandora/pandora/SITENAME.jsonc'
+
+* use an external data service, i.e.:
+
+    DATA_SERVICE = 'https://data.0xdb.org/api/'
+* webserver integration:
+ * nginx:
+
+    XACCELREDIRECT = True
+ * apache:
+
+    XSENDFILE = True
+
+* serve videos from other domain. to avoid some issues with browsers or for other reasons you might want to use another domain for your videos. several variables are expanded from the prefix: {uid}, {uid42}, {id}, {part}
+
+    VIDEO_PREFIX = "//video{uid}.pad.ma"
+    SESSION_COOKIE_DOMAIN = ".pad.ma"
+
+* enable debug output in http responds, otherwise a traceback will be available in Debug->View Logs... for admins
+
+    DEBUG=False
+## config.jsonc
+look at config.0xdb.jsonc, config.pandora.jsonc and config.padma.jsonc to get an idea of available options for now.
+
+## poster/icon scripts
+if you customize your scripts, replace poster.py, item_icon.py or list_icon.py with your version. 
+
+
+## logo, icon
+to customize your sites logo, icon replace static/png/logo.png or static/png/icon.png
+
+
+## customize views
+you can customize views or javascript files.
+i.e. to customize the welcome screen, copy static/js/pandora/home.js to static/js/pandora/home.SITEID.js
+(SITEID as defined in config.jsonc site.id) and change it. once you are done, run manage.py update_static