summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDashie <dashie@sigpipe.me>2019-09-10 16:32:36 +0200
committerDashie <dashie@sigpipe.me>2019-09-14 09:02:18 +0200
commita9b2cade696536d1f0c626586d1e25b7de874845 (patch)
tree2002ab749c79f053d6f253b72615a6d018191fe6 /README.md
parent535945b69ac98352e80ec816ff31f39154db774e (diff)
Add installation documentation
Diffstat (limited to 'README.md')
-rw-r--r--README.md93
1 files changed, 8 insertions, 85 deletions
diff --git a/README.md b/README.md
index 4784a2d4..0ec0d86d 100644
--- a/README.md
+++ b/README.md
@@ -15,98 +15,25 @@
<a href="https://sound.otter.sh/user/dashie">Example single user instance</a>
<a href="https://riot.im/app/#/room/#reel2bits:otter.sh">Matrix room: #reel2bits:otter.sh</a>
+ -
+ <a href="https://docs-develop.reel2bits.org">Installation & Documentation</a>
</p>
Reel2bits is a soundcloud-like self-hosted application. You can upload audio files and they get transcoded, and also compile them into albums.
ActivityPub federation is still a work in progress, everything else works.
-## Versions/packages requirement
- - Python >= 3.6 (all under 3.6 are not supported)
- - libmediainfo
- - Pydub dependencies: https://github.com/jiaaro/pydub#dependencies
-
## Installation
- Install PostgreSQL first for the database. MySQL or SQLITE3 are unsupported as we use PostgreSQL specific extensions.
- Makes sure that encoding is/will be in UNICODE/UTF-8
- git clone http://dev.sigpipe.me/dashie/reel2bits
- cd reel2bits
- pip3 install --requirement requirements.txt
- python3 setup.py install
- cp config.py.sample config.py
- $EDITOR config.py
- export FLASK_ENV=<development or production>
- $ create your postgresql database, like 'reel2bits'
- $ with the postgresql shell, run using superuser on the reel2bits database:
- CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
- flask db upgrade
- flask seed
- flask run
- Don't forget to update default Config by getting to "Your user" (top right) then "Config"
-
- Also install this tool : https://github.com/bbc/audiowaveform
- And adapt the path to it in config.py
-
-## Creating an user
-
-If you have enabled registration in config, the first user registered will be ADMIN !
-
-Or if you have disabled registration, use the ``` flask createuser ``` command to create an user.
-
-## Production running
- sudo easy_install3 virtualenv
- sudo su - reel2bits
- cd reel2bits
-
- >> install -> git part
-
- virtualenv -p /usr/bin/python3 venv
- or if python 3.6 from github repo:
- virtualenv -ppython3.6 venv
-
- source venv/bin/activate
- >> get back to install part
-
- pip install waitress
-
- # If you want SENTRY support (also add related things in config)
- pip install sentry-sdk[flask]
-
-
-Copy systemd services files ```docs/reel2bits-*.service``` to ```/etc/systemd/system/``` and adapt them to your setup.
-
- systemctl enable reel2bits-web reel2bits-worker
- systemctl start reel2bits-web reel2bits-worker
-
-Use ```docs/reel2bits.nginx``` as vhost template for ```X-Accel-Redirect``` part.
+The official documentation is available here: https://docs-develop.reel2bits.org/admin/index.html
## Development notes
-Run the backend with:
-
-```bash
-export AUTHLIB_INSECURE_TRANSPORT=1
-export FLASK_ENV=development
-flask run
-```
-
-Setup the frontend with `front/config/local.json`:
-
-```json
-{
- "target": "http://127.0.0.1:5000/"
-}
-```
-
-And run it with:
+The Developper documentation is available here: https://docs-develop.reel2bits.org/contributing.html
-```bash
-cd front
-npm run dev
-```
+## Translators documentation
-Then you can access the frontend on http://localhost:8081 and backend requests will be proxified properly.
+Refers to https://docs-develop.reel2bits.org/translators.html
## Docker
@@ -114,15 +41,11 @@ TODO
## Default config
- App Name: My reel2bits instance
+ - App description: This is a reel2bits instance
-## Workers
- Run the workers using:
-
- $ celery worker -A tasks.celery --loglevel=error
-
## Licensing
- AGPL v3
## Others projects inspired from
- - https://github.com/tsileo/microblog.pub from Little-Boxes
+ - https://github.com/tsileo/microblog.pub from Little-Boxes ActivityPub backend
- https://funkwhale.audio