pandora/README.md

59 lines
1.5 KiB
Markdown
Raw Normal View History

2016-04-15 12:21:24 +00:00
# pan.do/ra - open media archive
2020-05-30 01:27:51 +00:00
for more information about pan.do/ra visit our website at https://pan.do/ra
2019-07-14 16:20:52 +00:00
## Installing pan.do/ra
2016-04-15 12:21:24 +00:00
2020-05-30 01:27:51 +00:00
We recommend to run pan.do/ra inside of LXD or LXC or dedicated VM or server.
2019-07-14 16:20:52 +00:00
You will need at least 2GB of free disk space
2017-08-21 19:08:29 +00:00
2023-07-27 14:18:02 +00:00
pan.do/ra is known to work with Debian/12 (bookworm) and Ubuntu 20.04,
2019-07-14 16:20:52 +00:00
other distributions might also work, let us know if it works for you.
2016-04-15 12:21:24 +00:00
2019-07-14 17:47:20 +00:00
Use the following commands as root to install pan.do/ra and all dependencies:
2019-07-14 16:20:52 +00:00
```
2019-07-14 17:47:20 +00:00
cd /root
curl -sL https://pan.do/ra-install > pandora_install.sh
chmod +x pandora_install.sh
2020-05-30 10:28:50 +00:00
export BRANCH=stable # change to 'master' to get current developement version
2019-07-14 17:47:20 +00:00
./pandora_install.sh 2>&1 | tee pandora_install.log
2019-07-14 16:20:52 +00:00
```
2012-04-19 12:43:54 +00:00
2019-07-14 16:21:51 +00:00
For step by step installation, look at [pandora_install.sh](vm/pandora_install.sh)
2019-07-14 16:20:52 +00:00
## Configuration
2012-04-19 12:43:54 +00:00
2019-07-14 16:20:52 +00:00
pan.do/ra is mostly configured in two places:
2011-12-19 19:42:18 +00:00
2019-07-14 16:20:52 +00:00
### /srv/pandora/pandora/local_settings.py
2016-04-15 12:21:24 +00:00
2019-07-14 16:20:52 +00:00
this file contains local Django configuration overwrites,
like database configuration, email backend and more.
2016-04-15 12:21:24 +00:00
2019-07-14 16:20:52 +00:00
### /srv/pandora/pandora/config.jsonc
2019-07-14 16:20:52 +00:00
config.jsonc can be used in configure the pan.do/ra related
settings. From title to item keys to video resolutions.
2016-04-15 12:21:24 +00:00
2019-07-14 16:20:52 +00:00
More info at
https://code.0x2620.org/0x2620/pandora/wiki/Configuration
2016-04-15 12:21:24 +00:00
2019-07-14 16:20:52 +00:00
## Customization
2019-07-14 16:20:52 +00:00
pan.do/ra can be customized, this is mostly done by adding
JavaScript files that replace or enhance parts of pan.do/ra
2016-04-15 12:21:24 +00:00
2019-07-14 16:20:52 +00:00
More info at
https://code.0x2620.org/0x2620/pandora/wiki/Customization
## Update
To update your existing instlalation run
pandoractl update