magnetico-environment

magnetico-environment

Docker app from Dyon's Repository

Overview

magnetico is an autonomous (self-hosted) BitTorrent DHT indexer / crawler / search engine suite.

Archival Notice

Hello! 👋 I've been working on magnetico since 2017 (less so in the recent years) and seeing so many people interested in it and using it has been a great source of joy and pride for me. However, I have decided that it is for the best to acknowledge and admit openly that I no longer have as much time as I did in high school, nor any willingness to spend the little time I now have by working on magnetico or any other free software in general, except what I think is the most important problem in the world that I can work on at that moment.

Fork it, improve it, ship it; keep up the good fight against scarcity. ☀️

Bora <bora at boramalper.org>

magnetico

Autonomous (self-hosted) BitTorrent DHT search engine suite.

chat on gitterGoCII Best Practices

magnetico is the first autonomous (self-hosted) BitTorrent DHT search engine suite that is designed for end-users. The suite consists of two packages:

  • magneticod: Autonomous BitTorrent DHT crawler and metadata fetcher.
  • magneticow: Lightweight web interface for magnetico.

Both programs, combined together, allows anyone with a decent Internet connection to access the vast amount of torrents waiting to be discovered within the BitTorrent DHT space, without relying on any central entity.

magnetico liberates BitTorrent from the yoke of centralised trackers & web-sites and makes it truly decentralised. Finally!

Features

  • Easy installation & minimal requirements:
  • Near-zero configuration:
    • Both programs work out of the box, and magneticow can be used without a web-server too.
    • Detailed, step-by-step manual to guide you through the installation.
  • No reliance on any centralised entity:
    • magneticod trawls the BitTorrent DHT by "going" from one node to another, and fetches the metadata using the nodes without using trackers.
  • Resilience:
    • Unlike client-server model that web applications use, P2P networks are chaotic and magneticod is designed to handle all the operational errors accordingly.
      • Currently on paper, wait for the v1.0!
  • High performance implementation in Go:
    • magneticod utilizes every bit of your resources to discover as many infohashes & metadata as possible.
  • Built-in lightweight web interface:
    • magneticow features a lightweight web interface to help you access the database without getting on your way.

Screenshots

Click on the images to view full-screen.

The Homepage Searching for torrents ss
The Homepage Searching for torrents Viewing the metadata of a torrent

Why?

BitTorrent, being a distributed P2P file sharing protocol, has long suffered because of the centralised entities that people depended on for searching torrents (websites) and for discovering other peers (trackers). Introduction of DHT (distributed hash table) eliminated the need for trackers, allowing peers to discover each other through other peers and to fetch metadata from the leechers & seeders in the network. magnetico is the finishing move that allows users to search for torrents in the network, hence removing the need for centralised torrent websites.

Installation Instructions

WARNING:

magnetico is still under active construction, and is considered alpha software. Please use magnetico suite with care and follow the installation instructions carefully to install it & secure the installation. Feel perfectly free to send bug reports, suggestions, or whatever comes to your mind to send to us through GitHub or personal e-mail.

WARNING:

Do NOT clone the repository to install magnetico, as it is never meant to be stable (except releases of course).

  1. Install magneticod first by following its installation instructions.
  2. Install magneticow afterwards by following its installation instructions.

Docker

Run magneticod and magneticow with:

make docker

It will run magnetico from already built image on Docker Hub!

You should access magneticow at http://localhost:8080.

To build fresh images from source, first run:

make image

Then run make docker. It ensures you run updated images of magnetico.

License

All the code is licensed under AGPLv3, unless stated otherwise specifically. See COPYING for details.

Donations

Patreon

https://www.patreon.com/boramalper

PayPal

https://paypal.me/boramalper

Cryptocurrencies (Coinbase)

  • BTC: 3BLWjamWug3QQzcDDGwYLwuCqJyjcfYJB8
  • LTC: MRWX5SGCF7EvN15gpzT5b3KQD3Z91gH8qi
  • BCH: qqn07a58hax9l8pckq9j8ys6dsh2cnu4rsyztw2kj9
  • ETH: 0xe5A8e80bAA6129DF7eBB1B5302F9e2Ef4C6f6E62
  • ETC: 0x8964EcC86eaf043Bff2CdfE875E73D8095c26a58

Dedicated to Cemile Binay, in whose hands I thrived.

Bora M. ALPER bora@boramalper.org

Install magnetico-environment on Unraid in a few clicks.

Find magnetico-environment in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for magnetico-environment Review the template variables and paths Click Install

Download Statistics

68,798
Total Downloads
798
This Month
579
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
dyonr/magnetico-environment
Last Updated2021-02-12
First Seen2020-07-20

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
bash
Privileged
false

Template configuration

MAGNETICOW_USERNAMEVariable

Username used to access the magneticow web interface

Default
magnetico
Value
magnetico
MAGNETICOW_PASSWORDVariable

Password used to access the magneticow web interface

Default
magnetico
Value
magnetico
MAGNETICOW_PORT_MAPPINGPorttcp

The port that you will access magneticow on

Target
8080
Default
8556
Value
8556
MAGNETICOD_NEIGHBORSVariable

The maximum numbers of neighbors of an indexer

Default
1000
Value
1000
MAGNETICOD_LEECHESVariable

The maximum numbers of leeches

Default
50
Value
50
PUIDVariable

PUID that will be set on the magneticod database folder

Default
99
Value
99
PGIDVariable

PGID that will be set on the magneticod database folder

Default
100
Value
100
MAGNETICOW_ADDRESSVariable

Host address of magneticow

Default
0.0.0.0
Value
0.0.0.0
MAGNETICOD_ADDRESSVariable

IP-address used by magneticod for indexing on the DHT network

Default
0.0.0.0
Value
0.0.0.0
MAGNETICOD_INTERVALVariable

The indexing interval used by magneticod in seconds

Default
`1
Value
1
MAGNETICOD_PORTVariable

Port used by magneticod for indexing on the DHT network

Default
0
Value
0
MAGNETICOW_VERBOSEVariable

Container Variable: MAGNETICOW_VERBOSE

MAGNETICOD_VERBOSEVariable

Container Variable: MAGNETICOD_VERBOSE

Database LocationPathrw

The path where magneticod will store its database

Target
/root/.local/share/magneticod
Default
/mnt/user/appdata/magnetico
Value
/mnt/user/appdata/magnetico