# Joal

Joal is an open-source command-line ratio management tool for torrent seeding on private trackers, with an optional WebUI for configuration. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1277/joal

## Description

JOAL is an open-source command-line ratio management tool for torrent seeding on private trackers, with an optional WebUI for configuration. It fakes upload rates and manages simultaneous seeding sessions to help maintain account upload-to-download ratios. Designed for homelab users who seed on private trackers and want automated, self-hosted ratio management.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

45/100 (Fair), based on 3 of 4 factors.
- Maintained: 66 (last commit 98 days ago)
- Popular: 19 (8 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/digrouz/joal
- GitHub: https://github.com/digrouz/docker-joal
- Unraid: https://ca.unraid.net/apps/joal-05obgon1qiwu1f?q=joal

## Common questions

### Where should Joal's configuration be stored?

Mount a host directory to /config in the container. This is the configuration path shown in the docker usage example.

### How do I access the WebUI and protect it?

Open the host IP and port, then the secret obfuscation path followed by /ui/. Set JOAL_SECRET_OBFUSCATION_PATH to an alphanumeric path and JOAL_SECRET_TOKEN to a complicated password-like token.

### How do I change the port Joal listens on?

Set the JOAL_PORT environment variable to the desired port. The container's published port should use that same port.

### Can the Docker container run an update at startup?

Yes. Set AUTOUPGRADE=1 to enable the update at startup; the default value is 0.

### Can I set the container user and group IDs?

Yes. Pass UID and GID environment variables, which default to 12345.

---
Source: Our Local Host (https://ourlocalhost.com/app/1277/joal), the self-hosted and open-source app directory.