relay/docs/installation.md

68 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

2022-05-06 07:04:51 +00:00
# Installation
There are a few ways to install ActivityRelay. Follow one of the methods below, setup a reverse
proxy, and setup the relay to run via a supervisor. Example configs for caddy, nginx, and systemd
in `installation/`
## Pipx
Pipx uses pip and a custom venv implementation to automatically install modules into a Python
environment and is the recommended method. Install pipx if it isn't installed already. Check out
the [official pipx docs](https://pypa.github.io/pipx/installation/) for more in-depth instructions.
python3 -m pip install pipx
Now simply install ActivityRelay from pypi
2022-05-06 07:04:51 +00:00
pipx install activityrelay
2022-05-06 07:04:51 +00:00
Or from a cloned git repo.
pipx install .
Once finished, you can set up the relay via the setup command. It will ask a few questions to fill
out config options for your relay
~/.local/bin/activityrelay setup
2022-05-06 07:04:51 +00:00
Finally start it up with the run command.
~/.local/bin/activityrelay run
2022-05-06 07:04:51 +00:00
Note: Pipx requires python 3.7+. If your distro doesn't have a compatible version of python, it can
be installed via [pyenv](https://github.com/pyenv/pyenv).
2022-05-06 07:04:51 +00:00
## Pip
The instructions for installation via pip are very similar to pipx
2022-05-06 07:04:51 +00:00
python3 -m pip install activityrelay
2022-05-06 07:04:51 +00:00
or a cloned git repo.
python3 -m pip install .
Now run the configuration wizard
python3 -m relay setup
2022-05-06 07:04:51 +00:00
And start the relay when finished
python3 -m relay run
2022-05-06 07:04:51 +00:00
## Docker
Installation and management via Docker can be handled with the `docker.sh` script. To install
ActivityRelay, run the install command. Once the image is built and the container is created,
you will be asked to fill out some config options for your relay. An address and port can be
specified to change what the relay listens on.
2022-05-06 07:04:51 +00:00
./docker.sh install 0.0.0.0 6942
2022-05-06 07:04:51 +00:00
Finally start it up. It will be listening on TCP localhost:8080 by default.
2022-05-06 07:04:51 +00:00
./docker.sh start