diff options
author | Dashie <dashie@sigpipe.me> | 2019-09-10 16:32:36 +0200 |
---|---|---|
committer | Dashie <dashie@sigpipe.me> | 2019-09-14 09:02:18 +0200 |
commit | a9b2cade696536d1f0c626586d1e25b7de874845 (patch) | |
tree | 2002ab749c79f053d6f253b72615a6d018191fe6 /README.md | |
parent | 535945b69ac98352e80ec816ff31f39154db774e (diff) |
Add installation documentation
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 93 |
1 files changed, 8 insertions, 85 deletions
@@ -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 |