update README
This commit is contained in:
parent
e58781a963
commit
80c3a311b0
37
README.md
37
README.md
|
@ -1,12 +1,33 @@
|
||||||
# fediverse.space
|
# fediverse.space
|
||||||
fediverse.space is a tool to explore instances in the fediverse.
|
fediverse.space is a tool to explore instances in the fediverse 🌐
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
- For everything:
|
||||||
|
- Docker
|
||||||
|
- Docker-compose
|
||||||
|
- For the scraper + API:
|
||||||
|
- Python 3
|
||||||
|
- For laying out the graph:
|
||||||
|
- Java
|
||||||
|
- For the frontend:
|
||||||
|
- Yarn
|
||||||
|
|
||||||
## Running it
|
## Running it
|
||||||
* `cp config.json.template config.json` and enter your configuration details. I've used a postgres database for development.
|
### Backend
|
||||||
* Set the environment variable `FEDIVERSE_CONFIG` to point to the path of this file.
|
- `cp example.env .env` and modify environment variables as required
|
||||||
* `pip install -r requirements.txt`
|
- `docker-compose build`
|
||||||
* `yarn install`
|
- `docker-compose up -d`
|
||||||
* Make sure you have the Java 8 JRE (to run) or JDK (to develop) installed, and gradle
|
### Frontend
|
||||||
* For development, run `python manage.py runserver --settings=backend.settings.dev`
|
- `cd frontend && yarn install`
|
||||||
* In production, set the environment variable `DJANGO_SETTINGS_MODULE=backend.settings.production`
|
- `yarn start`
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
### Backend
|
||||||
|
- `python manage.py scrape` scrapes the entire fediverse
|
||||||
|
- `python manage.py build_graph` uses this information to lay out a graph
|
||||||
|
|
||||||
|
To run in production, use `docker-compose -f docker-compose.yml -f docker-compose.production.yml` instead of just `docker-compose`.
|
||||||
|
|
||||||
|
### Frontend
|
||||||
|
- `yarn build` to create an optimized build for deployment
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue