53 lines
917 B
Markdown
53 lines
917 B
Markdown
# s5p -- Installation
|
|
|
|
## Prerequisites
|
|
|
|
- Python >= 3.11
|
|
- pip
|
|
- Tor (optional, for Tor-based chains)
|
|
- podman + podman-compose (optional, for container deployment)
|
|
|
|
## Local Install
|
|
|
|
```bash
|
|
cd ~/git/s5p
|
|
python -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -e .
|
|
```
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
s5p --version
|
|
which s5p
|
|
```
|
|
|
|
## Symlink (alternative)
|
|
|
|
```bash
|
|
ln -sf ~/git/s5p/.venv/bin/s5p ~/.local/bin/s5p
|
|
```
|
|
|
|
## Container Install
|
|
|
|
```bash
|
|
cd ~/git/s5p
|
|
cp config/example.yaml config/s5p.yaml # edit with your proxies
|
|
make build # podman-compose build
|
|
make up # podman-compose up -d
|
|
```
|
|
|
|
The Alpine-based image (~59MB) contains only Python and PyYAML.
|
|
Application source and config are bind-mounted at runtime.
|
|
|
|
## Install Tor (optional)
|
|
|
|
```bash
|
|
sudo apt install tor
|
|
sudo systemctl enable --now tor
|
|
|
|
# Verify Tor SOCKS5 port
|
|
ss -tlnp | grep 9050
|
|
```
|