pandora/README.md

59 lines
1.5 KiB
Markdown

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