You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
boypt a9acf3e671 add arg DisableMmap 3 weeks ago
.github/workflows lint timeout 4 weeks ago
common lint: pkg server 4 weeks ago
engine add arg DisableMmap 3 weeks ago
scripts fix: purego as static 4 weeks ago
server add arg DisableMmap 3 weeks ago
static show sys info as list 1 month ago
.gitignore ignore yml 6 months ago
.gitmodules move scraper config into repo 2 years ago add scripts 2 years ago
Dockerfile update docker image 4 months ago
LICENSE added AGPLv3 instead of Creative Commons (#178) 4 years ago
Makefile add scripts 2 years ago update readme 4 months ago
docker-compose.yml add docker-compose 4 months ago
example-cloud-torrent.yaml add docker-compose 4 months ago
go.mod upgrade deps 2 months ago
go.sum upgrade deps 2 months ago
main.go startup info changes 1 month ago
scraper-config.json update scraper 5 months ago


Build Status

SimpleTorrent is a a self-hosted remote torrent client, written in Go (golang). Started torrents remotely, download sets of files on the local disk of the server, which are then retrievable or streamable via HTTP.

This project is a re-branded fork of cloud-torrent by jpillora.


  • Individual file download control (1.1.3+)
  • Run external program on tasks completion: DoneCmd
  • Stops task when seeding ratio reached: SeedRatio
  • Download/Upload speed limiter: UploadRate/DownloadRate
  • Detailed transfer stats in web UI.
  • Torrent Watcher
  • K8s/docker health-check endpoint /healthz
  • Extra trackers from external source
  • Protocol Handler to magnet:
  • Magnet RSS subscribing supported
  • Flexible config file accepts multiple formats (.json/.yaml/.toml) (by spf13/Viper) (1.2.0+)


  • Single binary
  • Cross platform
  • Embedded torrent search
  • Real-time updates
  • Mobile-friendly
  • Fast content server
  • IPv6 out of the box
  • Updated torrent engine from anacrolix/torrent



See the latest release or use the oneline script to do a quick install on a modern Linux machines.

bash <(wget -qO-

The script installs a systemd unit (under scripts/cloud-torrent.service) as service. Read further intructions: Auth And Security

If hope to specify a version, just append the version number to the command.

bash <(wget -qO- 1.3.3

Docker Docker Pulls

$ docker run -d -p 3000:3000 -v /path/to/my/downloads:/downloads -v /path/to/my/torrents:/torrents boypt/cloud-torrent

When running as a container, keep in mind:

  • You need also to expose your torrent incoming port (50007 by default) if you want to seed (-p 50007:50007). Also, you'll have to forward the port on your router.
  • Automatic port forwarding on your router via UPnP IGD will not work unless run in host mode (--net=host).

It's more practical to run docker-compose, see Wiki Page: DockerCompose



$ git clone
$ cd simple-torrent
$ ./scripts/


Commandline Options

See Wiki Command line Options

Configuration file

See Wiki Config File

Use with WEB servers (nginx/caddy)

See Wiki Behind WebServer (reverse proxying)