Jackett/README.md

805 lines
24 KiB
Markdown
Raw Normal View History

# Jackett
2017-05-04 19:55:41 +00:00
[![GitHub issues](https://img.shields.io/github/issues/Jackett/Jackett.svg?maxAge=60&style=flat-square)](https://github.com/Jackett/Jackett/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/Jackett/Jackett.svg?maxAge=60&style=flat-square)](https://github.com/Jackett/Jackett/pulls)
2020-04-17 22:07:58 +00:00
[![Build Status](https://dev.azure.com/Jackett/Jackett/_apis/build/status/Jackett.Jackett?branchName=master)](https://dev.azure.com/jackett/jackett/_build/latest?definitionId=1&branchName=master)
[![GitHub Releases](https://img.shields.io/github/downloads/Jackett/Jackett/total.svg?maxAge=60&style=flat-square)](https://github.com/Jackett/Jackett/releases/latest)
2017-05-04 19:55:41 +00:00
[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/jackett.svg?maxAge=60&style=flat-square)](https://hub.docker.com/r/linuxserver/jackett/)
[![Discord](https://img.shields.io/badge/discord-chat-7289DA.svg?maxAge=60&style=flat-square)](https://discord.gg/J865QuA)
2017-05-04 19:55:41 +00:00
2020-06-22 06:58:06 +00:00
This project is a new fork and is recruiting development help. If you are able to help out please [contact us](https://github.com/Jackett/Jackett/issues/8180).
2017-05-04 19:55:41 +00:00
Please see our [troubleshooting and contributing guidelines](CONTRIBUTING.md) before submitting any issues or pull requests
Jackett works as a proxy server: it translates queries from apps ([Sonarr](https://github.com/Sonarr/Sonarr), [Radarr](https://github.com/Radarr/Radarr), [SickRage](https://sickrage.github.io/), [CouchPotato](https://couchpota.to/), [Mylar](https://github.com/evilhero/mylar), [Lidarr](https://github.com/lidarr/lidarr), [DuckieTV](https://github.com/SchizoDuckie/DuckieTV), [qBittorrent](https://www.qbittorrent.org/), [Nefarious](https://github.com/lardbit/nefarious) etc.) into tracker-site-specific http queries, parses the html response, then sends results back to the requesting software. This allows for getting recent uploads (like RSS) and performing searches. Jackett is a single repository of maintained indexer scraping & translation logic - removing the burden from other apps.
2017-05-04 19:55:41 +00:00
Developer note: The software implements the [Torznab](https://github.com/Sonarr/Sonarr/wiki/Implementing-a-Torznab-indexer) (with [nZEDb](https://github.com/nZEDb/nZEDb/blob/dev/docs/newznab_api_specification.txt) category numbering) and [TorrentPotato](https://github.com/RuudBurger/CouchPotatoServer/wiki/Couchpotato-torrent-provider) APIs.
#### Supported Systems
* Windows 7SP1 or greater
* Linux [supported operating systems here](https://github.com/dotnet/core/blob/master/release-notes/3.1/3.1-supported-os.md#linux)
* macOS 10.13 or greater
2017-05-04 19:55:41 +00:00
<details> <summary> <b> Supported Public Trackers </b> </summary>
* 1337x
* 7torrents
* ACG.RIP
2020-04-25 03:31:46 +00:00
* ACGsou (36DM)
2017-05-07 11:27:30 +00:00
* Anidex
* AniLibria
2020-10-18 20:34:13 +00:00
* Animedia
* Anime Tosho
* AniRena
* AniSource
* AudioBook Bay (ABB)
* BigFANGroup
* BitRu
* BT.etree
* BTDB
* BTDIGG
* BTSOW
* Byrutor
* CiliPro (LIAORENCILI)
* ConCen
2019-09-07 22:41:22 +00:00
* Corsaro.red
* cpasbien
* cpasbienClone
* Demonoid
* dmhy
* E-Hentai
* EliteTorrent.biz
* Epizod
* ETTV
* EXT Torrents
* ExtraTorrent.cd
* EZTV
* Filebase
* FireBit
* Frozen Layer
* GamesTorrents
2017-09-15 15:08:33 +00:00
* GkTorrent
* GloDLS
* GTorrent
* HDReactor
* IBit
* Idope
* Il CorSaRo Blu
* Il Corsaro Nero <!-- maintained by bonny1992 -->
* Internet Archive (archive.org)
* Isohunt2
* iTorrent
2019-10-10 20:11:38 +00:00
* KickAssTorrent (kat.li)
* KickAssTorrent (KATcr)
* Legit Torrents
* LePorno.info
2017-05-04 19:55:41 +00:00
* LimeTorrents
* LinuxTracker
* MacTorrents
* Magnet4You
* MagnetDL
* MejorTorrent <!-- maintained by ivandelabeldad -->
* Monova
* MovCr
* MoviesDVDR
* MyPornClub
* NewPCT (aka: tvsinpagar, descargas2020, torrentlocura, torrentrapid, tumejortorrent, pctnew, etc)
2019-10-14 03:09:59 +00:00
* Newstudio
* Nitro
* NNTT
* NoNaMe Club (NNM-Club)
2017-05-06 13:30:00 +00:00
* Nyaa-Pantsu
* Nyaa.si
* OneJAV
* OxTorrent
* ParnuXi
* PC-torrent
* PiratBit
* Pirateiro
* Pornforall
* PornLeech
* PornoLive
2020-03-07 04:43:33 +00:00
* PornoRip
2020-03-07 03:20:03 +00:00
* PornoTor
* ProPorn
* ProStyleX
* Rapidzona
2017-05-04 19:55:41 +00:00
* RARBG
* RinTor
* RinTorNeT
* Rus-media
* RuTor
* RuTracker.RU
* seleZen
* Sexy-Pics
* ShizaProject
* shokweb
2017-05-04 19:55:41 +00:00
* ShowRSS
* SkyTorrentsClone
* Solid Torrents
* sosulki
* sukebei-Pantsu
* sukebei.Nyaa.si
* The Pirate Bay (TPB)
* Tokyo Tosho
* TopNow
* Torlock
* TOROS
* Torrent Bomb (토렌트봄)
* Torrent Downloads (TD)
* Torrent Oyun indir
* torrent-pirat
* Torrent4You
* Torrent9
* Torrent9Clone
* TorrentDownload
2019-02-01 03:55:14 +00:00
* TorrentFunk
2019-10-10 20:11:38 +00:00
* TorrentGalaxy (TGx)
* TorrentKitty
* TorrentMafya
* TorrentParadise
* TorrentProject2
* TorrentQuest
* Torrents.csv
* Torrentv
* TorrentView (토렌트뷰)
2017-05-04 19:55:41 +00:00
* Torrentz2
* Torrentz2k
* truPornolabs
2019-10-13 18:51:48 +00:00
* Underverse
* UnionDHT
* VST Torrents
* XFSUB
* xxxAdultTorrent
* xxxtor
* xxxtorrents
* YourBittorrent
* YTS.ag
* zetorrents
2017-09-15 06:01:10 +00:00
* Zooqle
</details>
<details> <summary> <b> Supported Semi-Private Trackers </b> </summary>
2018-01-29 18:38:57 +00:00
* AniDUB
* ArenaBG
* BaibaKo
* BookTracker
* CasStudioTV
* cool-torrent
* Darmowe torrenty
* Deildu
* DimeADozen (EzTorrent)
* DXP (Deaf Experts)
* EniaHD
* Erzsebet
* Erzsebet.pl
* ExKinoRay
* ExtremlymTorrents (XTR)
* Gay-Torrents.net
* Gay-Torrents.org
* HD Dolby
* HamsterStudio
* IV-Torrents
* KinoNaVse100
* Kinorun
* Kinozal
* Korsar
* LostFilm.tv
* MVGroup Forum
* MVGroup Main
* Marine Tracker
* Metal Tracker
* MuziekFrabriek
* NetHD (VietTorrent)
* PornoLab
* PussyTorrents
* Rainbow Tracker
* RiperAM
2018-10-12 03:56:09 +00:00
* RockBox
* RuTracker
* Rustorka
* SDkino
* Sharewood
* SkTorrent
* SkTorrent-org
* Toloka.to
* Torrent-Explosiv
* Torrents-Local
* TribalMixes
* Union Fansub
* YggTorrent (YGG)
* Ztracker
</details>
<details> <summary> <b> Supported Private Trackers </b> </summary>
* 0day.kiev
* 1ptbar
2017-05-04 19:55:41 +00:00
* 2 Fast 4 You
* 32Pages (32P)
* 3ChangTrai (3CT)
* 3D Torrents (3DT)
* 3evils
* 4thD (4th Dimension)
* 52PT
* 720pier
2017-05-04 19:55:41 +00:00
* Abnormal
* Acid Lounge (A-L)
* Aftershock
* Aidoru!Online
* Aither
2018-11-01 15:55:00 +00:00
* AlphaRatio (AR)
* AmigosShareClub
2019-02-09 06:20:44 +00:00
* AnimeBytes (AB)
2018-11-01 15:55:00 +00:00
* AnimeTorrents (AnT)
2018-12-28 11:14:16 +00:00
* Anthelion
* Araba Fenice (Phoenix)
* ArabP2P
* Asgaard (AG)
2018-12-29 18:59:22 +00:00
* AsianCinema
* AST4u
* Asylum Share
* AudioNews (AN)
* Audiobook Torrents (ABT + RNS)
2020-05-24 12:16:05 +00:00
* AvistaZ (AsiaTorrents)
* Awesome-HD (AHD)
* Borgzelle
* BTGigs (TG)
* BTNext (BTNT)
* BTSCHOOL
* Back-ups
* bB
* BakaBT
* BeiTai
2018-11-01 15:55:00 +00:00
* BeyondHD (BHD)
* Bibliotik
* BIGTorrent
2018-08-25 16:13:04 +00:00
* BigTower
2017-05-04 19:55:41 +00:00
* Bit-City Reloaded
* BIT-HDTV
* BiT-TiTAN
2017-05-04 19:55:41 +00:00
* BitHUmen
2019-03-25 14:30:21 +00:00
* BitTorrentFiles
2020-04-30 21:28:03 +00:00
* BiTTuRK
* Bithorlo (BHO)
* Bitspyder
* BJ-Share (BJ)
2017-05-04 19:55:41 +00:00
* BlueBird
2018-11-01 15:55:00 +00:00
* Blutopia (BLU)
* Boxing Torrents
* Brasil Tracker
* BroadCity
* BroadcasTheNet (BTN)
2017-05-20 14:52:03 +00:00
* BrokenStones
* BWTorrents
2017-12-01 13:13:09 +00:00
* CCFBits
* CGPeers
2017-05-04 19:55:41 +00:00
* CHDBits
* Carp-Hunter
* Carpathians
* CartoonChaos (CC)
* CasaTorrent
* ChannelX
* ChileBT
* Cinecalidad
* CinemaMovies
2018-11-01 15:55:00 +00:00
* CinemaZ (EuTorrents)
* Cinemageddon
* Cinematik
2017-05-04 19:55:41 +00:00
* Classix
* Concertos
* CrazyHD
* CrazySpirits
* CrnaBerza
2019-02-09 06:20:44 +00:00
* DanishBits (DB)
* Darius Tracker
* Dark-Shadow
* Dark Tracker
* Das Unerwartete
* DataScene (DS)
* DesiReleasers
* DesiTorrents
2017-05-04 19:55:41 +00:00
* Diablo Torrent
2020-07-07 20:51:23 +00:00
* DICMusic
* DigitalCore
* DivTeam
* DivxTotal
* DocumentaryTorrents (DT)
2017-05-04 19:55:41 +00:00
* Dragonworld Reloaded
* DXDHD
* EbookParadijs
* Ebooks-Shares
* EfectoDoppler
* Elite-Tracker
2018-11-01 15:55:00 +00:00
* Empornium (EMP)
* EpubLibre
* eShareNet
* eStone (XiDER, BeLoad)
2017-05-04 19:55:41 +00:00
* Ethor.net (Thor's Land)
* ExoticaZ (YourExotic)
* ExtremeBits
* ExtremeTorrents
2017-05-04 19:55:41 +00:00
* FANO.IN
* Fantastic Heaven
2018-02-06 16:40:05 +00:00
* Femdomcult
* FileList (FL)
* Film-Paleis
* FinElite (FE)
* FinVip
* FocusX
* Fou-Du-Cinema
* FreeTorrent
2017-05-04 19:55:41 +00:00
* FullMixMusic
2019-02-09 06:20:44 +00:00
* FunFile (FF)
* FunReleases
2018-11-01 15:55:00 +00:00
* FunkyTorrents (FT)
2019-02-09 06:20:44 +00:00
* Fuzer (FZ)
* GAYtorrent.ru
* GFXPeers
* Galeriens (LaPauseTorrents)
2018-11-01 15:55:00 +00:00
* GazelleGames (GGn)
* Generation-Free
2017-09-17 13:02:03 +00:00
* GigaTorrents
* GimmePeers (formerly ILT)
* GiroTorrent
* GreekDiamond
2017-05-04 19:55:41 +00:00
* Greek Team
* HaiDan
* HacheDe
* HD-Bits.com
* HD-Forever (HDF)
* HD-Olimpo
2018-11-01 15:55:00 +00:00
* HD-Only (HDO)
* HD-Space (HDS)
* HD-Spain
2018-11-01 15:55:00 +00:00
* HD-Torrents (HDT)
* HD4FANS
* HDArea (HDA)
2017-05-04 19:55:41 +00:00
* HDBits
* HDCenter
* HDChina (HDWing)
* HDC (HDCiTY)
* HDCity
* HDDisk (HDD)
2018-11-01 15:55:00 +00:00
* HDHome (HDBigger)
* HDME
* HDRoute
2017-05-04 19:55:41 +00:00
* HDSky
* HDStreet
* HDTime
* HDTorrents.it
* HDTurk
* HDU
* HDZone
2017-05-04 19:55:41 +00:00
* Hebits
* HellasTZ
2017-05-04 19:55:41 +00:00
* Hon3y HD
* Horror Site
* HQSource (HQS)
* HuSh
2017-05-04 19:55:41 +00:00
* ICE Torrent
* IPTorrents (IPT)
2019-02-09 06:20:44 +00:00
* ImmortalSeed (iS)
* Immortuos
2017-05-04 19:55:41 +00:00
* Insane Tracker
* IPTorrents (IPT)
2017-05-04 19:55:41 +00:00
* JPopsuki
* JPTV
2017-05-04 19:55:41 +00:00
* Karagarga
* Keep Friends
* LastFiles
2020-10-14 00:56:00 +00:00
* LatinoP2P
* Le Saloon
* LeChaudron
* LeagueHD
* LearnFlakes
* LegacyHD (HD4Free)
* Libble
* LibraNet (LN)
2017-05-04 19:55:41 +00:00
* LinkoManija
* LosslessClub
* M-Team TP (MTTP)
* MaDs Revolution
2018-11-01 15:55:00 +00:00
* Magico (Trellas)
* Majomparádé (TurkDepo)
* MicroBit (µBit)
* Milkie
* MMA-Torrents
* MNV (Max-New-Vision)
2017-05-04 19:55:41 +00:00
* Mononoké-BT
2018-11-01 15:55:00 +00:00
* MoreThanTV (MTV)
* Movie Zone (Mz)
2019-02-09 06:20:44 +00:00
* MyAnonamouse (MAM)
* myAmity
2017-05-04 19:55:41 +00:00
* MySpleen
* NBTorrents
* NCore
2019-02-09 06:20:44 +00:00
* Nebulance (NBL) (TransmiTheNet)
* NetCosmo
* NetLab
2017-05-04 19:55:41 +00:00
* New Real World
* NorBits
* notwhat.cd
* oMg[WtF]trackr
* OnlineSelfEducation
* ONLYscene
* Orpheus
* OshenPT
* Ourbits (HDPter)
* P2PBG
* P2PElite
* Partis
2018-11-01 15:55:00 +00:00
* PassThePopcorn (PTP)
* Peers.FM
* Pirata Digital
2019-02-09 06:20:44 +00:00
* PirateTheNet (PTN)
* PixelCove (Ultimate Gamer)
* PiXELHD (PxHD)
* Pleasuredome
* PolishSource (PS)
2017-05-04 19:55:41 +00:00
* PolishTracker
* PornBits (PB)
* Pornbay
2017-05-04 19:55:41 +00:00
* Pretome
2018-11-01 15:55:00 +00:00
* PrivateHD (PHD)
* ProAudioTorrents (PAT)
* Psytorrents
* PTerClub
* PTFiles (PTF)
* PThome
* PTMSG
* PTSBAO
* PuntoTorrent
2020-03-27 00:54:02 +00:00
* PuroVicio
* Puur-Hollands
* PWTorrents (PWT)
* R3V WTF!
* Racing4Everyone (R4E)
* RacingForMe (RFM)
* Red Star Torrent (RST)
* Redacted (PassTheHeadphones)
* RetroFlix
2017-05-04 19:55:41 +00:00
* RevolutionTT
* Romanian Metal Torrents (RMT)
* RPTorrents
2017-05-04 19:55:41 +00:00
* SceneFZ
2018-11-09 15:29:31 +00:00
* SceneHD
* ScenePalace (SP)
* SceneRush
2017-05-04 19:55:41 +00:00
* SceneTime
* SDBits
2017-05-04 19:55:41 +00:00
* Secret Cinema
* SeedFile (SF)
* ShareUniversity
* Shareisland
2017-05-04 19:55:41 +00:00
* Shazbat
* Shellife (SL)
* SiamBIT
* SnowPT (SSPT)
* SoulVoice
* SpaceTorrent
2017-05-04 19:55:41 +00:00
* SpeedCD
* Speedmaster HD
2017-08-28 13:49:44 +00:00
* SpeedTorrent Reloaded
* Spirit of Revolution
* SportHD
* SportsCult
* SpringSunday
* Superbits (SBS)
* TakeaByte
* Tapochek
2017-05-04 19:55:41 +00:00
* Tasmanit
* TeamHD
* TeamOS
* TEKNO3D
* TellyTorrent
* TenYardTorrents (TYT)
* The-Unknown
* The Falling Angels (TFA)
2017-05-04 19:55:41 +00:00
* The Geeks
2018-11-01 15:55:00 +00:00
* The Horror Charnel (THC)
2017-05-04 19:55:41 +00:00
* The New Retro
* The Occult
2017-05-04 19:55:41 +00:00
* The Place
2018-11-01 15:55:00 +00:00
* The Shinning (TsH)
2017-05-04 19:55:41 +00:00
* The Show
* The Vault
* TheAudioScene
* TheEmpire (TE)
* TJUPT
* TLFBits
2020-05-14 05:23:43 +00:00
* ToTheGlory (TTG)
2019-02-09 06:20:44 +00:00
* Torrent Network (TN)
* Torrent Sector Crew (TSC)
* Torrent-Syndikat
* TOrrent-tuRK (TORK)
* Torrent.LT
* TorrentBD
2019-02-09 06:20:44 +00:00
* TorrentBytes (TBy)
2019-04-02 14:55:39 +00:00
* TorrentCCF (TCCF)
2019-02-09 06:20:44 +00:00
* TorrentDay (TD)
* TorrentDB
* TorrentFactory
2017-05-04 19:55:41 +00:00
* TorrentHR
* TorrentHeaven
2018-11-01 15:55:00 +00:00
* TorrentLeech (TL)
* TorrentLeech.pl
2018-11-01 15:55:00 +00:00
* TorrentSeeds (TS)
* Torrentech (TTH)
* Torrenting (TT)
* Torrentland
2020-10-14 00:56:00 +00:00
* TotallyKids (TK)
2017-05-04 19:55:41 +00:00
* TranceTraffic
* Trezzor
* TTsWEB
* TurkSeed
2019-12-23 05:51:42 +00:00
* TurkTorrent (TT)
* TV Chaos UK (TVCUK)
* TV-Vault
* TVstore
* Twilight Torrents
* Twilights Zoom
* U2 (U2分享園@動漫花園)
2017-05-04 19:55:41 +00:00
* UHDBits
* UnionGang
* UnlimitZ
* Vizuk
2020-02-11 03:21:45 +00:00
* WDT (Wrestling Desires Torrents / Ultimate Wrestling Torrents)
* Witch-Hunter (Demon-Site)
* wOOt
* World-In-HD
* x-ite.me (XM)
* xBytesV2
2019-02-09 06:20:44 +00:00
* XSpeeds (XS)
* XWT-Classics
* XWTorrents (XWT)
2017-05-04 19:55:41 +00:00
* Xthor
* XtreMeZone (MYXZ)
* YDYPT
* YingK
2017-07-06 18:37:29 +00:00
* Zamunda.net
* Zelka.org
</details>
2017-05-04 19:55:41 +00:00
2020-01-01 00:16:28 +00:00
Trackers marked with [![(invite needed)][inviteneeded]](#) have no active maintainer and are missing features or are broken. If you have an invite for them please send it to garfieldsixtynine -at- gmail.com to get them fixed/improved.
2018-04-07 16:48:13 +00:00
### Aggregate indexers
A special "all" indexer is available at `/api/v2.0/indexers/all/results/torznab`.
2018-04-07 16:48:13 +00:00
It will query all configured indexers and return the combined results.
2019-01-02 12:14:04 +00:00
If your client supports multiple feeds it's recommended to add each indexer directly instead of using the all indexer.
Using the all indexer has no advantages (besides reduced management overhead), only disadvantages:
2019-02-19 17:40:36 +00:00
* you lose control over indexer specific settings (categories, search modes, etc.)
* mixing search modes (IMDB, query, etc.) might cause low-quality results
2019-01-02 12:14:04 +00:00
* indexer specific categories (>= 100000) can't be used.
* slow indexers will slow down the overall result
* total results are limited to 1000
To get all Jackett indexers including their capabilities you can use `t=indexers` on the all indexer. To get only configured/unconfigured indexers you can also add `configured=true/false` as a query parameter.
2018-04-07 16:48:13 +00:00
2017-05-04 19:55:41 +00:00
## Installation on Windows
2017-05-04 19:55:41 +00:00
We recommend you install Jackett as a Windows service using the supplied installer. You may also download the zipped version if you would like to configure everything manually.
To get started with using the installer for Jackett, follow the steps below:
1. Download the latest version of the Windows installer, "Jackett.Installer.Windows.exe" from the [releases](https://github.com/Jackett/Jackett/releases/latest) page.
2. When prompted if you would like this app to make changes to your computer, select "yes".
3. If you would like to install Jackett as a Windows Service, make sure the "Install as Windows Service" checkbox is filled.
4. Once the installation has finished, check the "Launch Jackett" box to get started.
5. Navigate your web browser to http://127.0.0.1:9117
2017-05-04 19:55:41 +00:00
6. You're now ready to begin adding your trackers and using Jackett.
When installed as a service the tray icon acts as a way to open/start/stop Jackett. If you opted to not install it as a service then Jackett will run its web server from the tray tool.
Jackett can also be run from the command line if you would like to see log messages (Ensure the server isn't already running from the tray/service). This can be done by using "JackettConsole.exe" (for Command Prompt), found in the Jackett data folder: "%ProgramData%\Jackett".
2017-05-04 19:55:41 +00:00
2019-03-10 01:21:06 +00:00
## Install on Linux (AMDx64)
On most operating systems all the required dependencies will already be present. In case they are not, you can refer to this page https://github.com/dotnet/core/blob/master/Documentation/linux-prereqs.md
2019-03-10 01:21:06 +00:00
### Install as service
2019-05-03 21:28:39 +00:00
1. Download and extract the latest `Jackett.Binaries.LinuxAMDx64.tar.gz` release from the [releases page](https://github.com/Jackett/Jackett/releases)
2019-10-07 22:51:08 +00:00
2. To install Jackett as a service, open a Terminal, cd to the jackett folder and run `sudo ./install_service_systemd.sh` You need root permissions to install the service. The service will start on each logon. You can always stop it by running `systemctl stop jackett.service` from Terminal. You can start it again it using `systemctl start jackett.service`. Logs are stored as usual under `~/.config/Jackett/log.txt` and also in `journalctl -u jackett.service`.
### Run without installing as a service
2019-10-07 22:51:08 +00:00
Download and extract the latest `Jackett.Binaries.LinuxAMDx64.tar.gz` release from the [releases page](https://github.com/Jackett/Jackett/releases), open a Terminal, cd to the jackett folder and run Jackett with the command `./jackett`
### home directory
If you want to run it with a user without a /home directory you need to add `Environment=XDG_CONFIG_HOME=/path/to/folder` to your systemd file, this folder will be used to store your config files.
2019-03-10 01:21:06 +00:00
## Install on Linux (ARMv7 or above)
On most operating systems all the required dependencies will already be present. In case they are not, you can refer to this page https://github.com/dotnet/core/blob/master/Documentation/linux-prereqs.md
2019-03-10 01:21:06 +00:00
### Install as service
1. Download and extract the latest `Jackett.Binaries.LinuxARM32.tar.gz` or `Jackett.Binaries.LinuxARM64.tar.gz` (32 bit is the most common on ARM) release from the [releases page](https://github.com/Jackett/Jackett/releases)
2019-10-07 22:51:08 +00:00
2. To install Jackett as a service, open a Terminal, cd to the jackett folder and run `sudo ./install_service_systemd.sh` You need root permissions to install the service. The service will start on each logon. You can always stop it by running `systemctl stop jackett.service` from Terminal. You can start it again it using `systemctl start jackett.service`. Logs are stored as usual under `~/.config/Jackett/log.txt` and also in `journalctl -u jackett.service`.
### Run without installing as a service
2019-10-07 22:51:08 +00:00
Download and extract the latest `Jackett.Binaries.LinuxARM32.tar.gz` or `Jackett.Binaries.LinuxARM64.tar.gz` (32 bit is the most common on ARM) release from the [releases page](https://github.com/Jackett/Jackett/releases), open a Terminal, cd to the jackett folder and run Jackett with the command `./jackett`
### home directory
If you want to run it with a user without a /home directory you need to add `Environment=XDG_CONFIG_HOME=/path/to/folder` to your systemd file, this folder will be used to store your config files.
2019-03-10 01:21:06 +00:00
## Installation on Linux (ARMv6 or below)
2018-06-05 05:24:05 +00:00
1. Install [Mono 5.8](http://www.mono-project.com/download/#download-lin) or better (using the latest stable release is recommended)
2017-05-04 19:55:41 +00:00
* Follow the instructions on the mono website and install the `mono-devel` and the `ca-certificates-mono` packages.
* On Red Hat/CentOS/openSUSE/Fedora the `mono-locale-extras` package is also required.
2. Install libcurl:
* Debian/Ubuntu: `apt-get install libcurl4-openssl-dev`
2017-05-04 19:55:41 +00:00
* Redhat/Fedora: `yum install libcurl-devel`
* For other distros see the [Curl docs](http://curl.haxx.se/dlwiz/?type=devel).
3. Download and extract the latest `Jackett.Binaries.Mono.tar.gz` release from the [releases page](https://github.com/Jackett/Jackett/releases) and run Jackett using mono with the command `mono --debug JackettConsole.exe`.
2019-03-10 01:21:06 +00:00
4. (Optional) To install Jackett as a service, open the Terminal and run `sudo ./install_service_systemd_mono.sh` You need root permissions to install the service. The service will start on each logon. You can always stop it by running `systemctl stop jackett.service` from Terminal. You can start it again it using `systemctl start jackett.service`. Logs are stored as usual under `~/.config/Jackett/log.txt` and also in `journalctl -u jackett.service`.
2017-05-04 19:55:41 +00:00
If you want to run it with a user without a /home directory you need to add `Environment=XDG_CONFIG_HOME=/path/to/folder` to your systemd file, this folder will be used to store your config files.
2017-09-17 13:05:42 +00:00
2018-05-21 13:51:07 +00:00
Mono must be compiled with the Roslyn compiler (default), using MCS will cause "An error has occurred." errors (See https://github.com/Jackett/Jackett/issues/2704).
2018-05-21 10:24:39 +00:00
### Installation on Linux via Ansible
On a CentOS/RedHat 7 system: [jewflix.jackett](https://galaxy.ansible.com/jewflix/jackett)
On an Ubuntu 16 system: [chrisjohnson00.jackett](https://galaxy.ansible.com/chrisjohnson00/jackett)
## Installation on macOS
### Prerequisites
2020-01-03 19:16:36 +00:00
macOS 10.13 or greater
### Install as service
2019-03-28 09:23:45 +00:00
1. Download and extract the latest `Jackett.Binaries.macOS.tar.gz` release from the [releases page](https://github.com/Jackett/Jackett/releases).
2. Open the extracted folder and double-click on `install_service_macos`.
3. If the installation was a success, you can close the Terminal window.
2018-01-29 18:38:57 +00:00
The service will start on each logon. You can always stop it by running `launchctl unload ~/Library/LaunchAgents/org.user.Jackett.plist` from Terminal. You can start it again it using `launchctl load ~/Library/LaunchAgents/org.user.Jackett.plist`.
Logs are stored as usual under `~/.config/Jackett/log.txt`.
### Run without installing as a service
2019-03-28 09:25:33 +00:00
Download and extract the latest `Jackett.Binaries.macOS.tar.gz` release from the [releases page](https://github.com/Jackett/Jackett/releases) and run Jackett with the command `./jackett`.
2017-05-04 19:55:41 +00:00
## Installation using Docker
Detailed instructions are available at [LinuxServer.io Jackett Docker](https://hub.docker.com/r/linuxserver/jackett/). The Jackett Docker is highly recommended, especially if you are having Mono stability issues or having issues running Mono on your system e.g. QNAP, Synology. Thanks to [LinuxServer.io](https://linuxserver.io)
2017-05-04 19:55:41 +00:00
2017-05-04 19:55:41 +00:00
## Installation on Synology
Jackett is available as a beta package from [SynoCommunity](https://synocommunity.com/)
2017-05-04 19:55:41 +00:00
## Running Jackett behind a reverse proxy
When running jackett behind a reverse proxy make sure that the original hostname of the request is passed to Jackett. If HTTPS is used also set the X-Forwarded-Proto header to "https". Don't forget to adjust the "Base Path Override" Jackett option accordingly.
Example config for apache:
```
<Location /jackett>
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto expr=%{REQUEST_SCHEME}
ProxyPass http://127.0.0.1:9117
ProxyPassReverse http://127.0.0.1:9117
</Location>
```
Example config for Nginx:
```
location /jackett {
proxy_pass http://127.0.0.1:9117;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $http_host;
proxy_redirect off;
}
```
## Configuring OMDb
This feature is used as a fallback (when using the aggregate Indexer) to get the movie/series title if only the IMDB ID is provided in the request.
To use it, please just request a free API key on [OMDb](http://www.omdbapi.com/apikey.aspx) (1,000 daily requests limit) and paste the key in Jackett
2017-05-04 19:55:41 +00:00
## Command line switches
2017-05-04 19:55:41 +00:00
You can pass various options when running via the command line:
2017-05-04 19:55:41 +00:00
<details> <summary> Command Line Switches </summary>
2017-05-04 19:55:41 +00:00
- `-i, --Install` Install Jackett windows service (Must be admin)
- `-s, --Start` Start the Jacket Windows service (Must be admin)
- `-k, --Stop` Stop the Jacket Windows service (Must be admin)
- `-u, --Uninstall` Uninstall Jackett windows service (Must be admin).
2017-05-19 15:33:04 +00:00
- `-r, --ReserveUrls` (Re)Register windows port reservations (Required for
listening on all interfaces).
2017-05-04 19:55:41 +00:00
- `-l, --Logging` Log all requests/responses to Jackett
2017-05-04 19:55:41 +00:00
- `-t, --Tracing` Enable tracing
- `-c, --UseClient` Override web client selection.
[automatic(Default)/httpclient/httpclient2]
- `-j, --ProxyConnection` use proxy - e.g. 127.0.0.1:8888
- `-x, --ListenPublic` Listen publicly
- `-z, --ListenPrivate` Only allow local access
- `-p, --Port` Web server port
2017-05-04 19:55:41 +00:00
- `-m, --MigrateSettings` Migrate settings manually (Must be an admin on Windows)
2017-05-04 19:55:41 +00:00
- `-n, --IgnoreSslErrors` [true/false] Ignores invalid SSL certificates
2019-01-26 07:39:05 +00:00
- `-d, --DataFolder` Specify the location of the data folder (Must be an admin on Windows)
- e.g. --DataFolder="D:\Your Data\Jackett\".
- Don't use this on Unix (mono) systems. On Unix just adjust the HOME directory of the user to the datadir or set the XDG_CONFIG_HOME environment variable.
2019-01-26 07:39:05 +00:00
- `--NoRestart` Don't restart after update
2019-01-26 07:39:05 +00:00
- `--PIDFile` Specify the location of PID file
2019-01-26 07:39:05 +00:00
- `--NoUpdates` Disable automatic updates
2019-01-26 07:39:05 +00:00
- `--help` Display this help screen.
2019-01-26 07:39:05 +00:00
- `--version` Display version information.
</details>
2018-03-29 17:17:27 +00:00
## Building from source
### Windows
2018-06-27 12:11:57 +00:00
* Install the .NET Core [SDK](https://www.microsoft.com/net/download/windows)
2019-03-03 04:32:55 +00:00
* Clone Jackett
* Open PowerShell and from the `src` directory, run `dotnet restore`
* Open the Jackett solution in Visual Studio 2019 (version 16.4 or above)
* Right-click on the Jackett solution and click 'Rebuild Solution' to restore NuGet packages
* Select Jackett.Server as the startup project
* In the drop-down menu of the run button select "Jackett.Server" instead of "IIS Express"
2018-03-29 17:17:27 +00:00
* Build/Start the project
### OSX
2018-12-26 03:37:03 +00:00
```bash
# manually install osx dotnet via:
2018-12-26 03:37:03 +00:00
https://dotnet.microsoft.com/download?initial-os=macos
# then:
2018-12-26 03:37:03 +00:00
git clone https://github.com/Jackett/Jackett.git
cd Jackett/src
2018-12-26 03:37:03 +00:00
# dotnet core version
dotnet publish Jackett.Server -f netcoreapp3.1 --self-contained -r osx-x64 -c Debug # takes care of everything
./Jackett.Server/bin/Debug/netcoreapp3.1/osx-x64/jackett # run jackett
2018-12-26 03:37:03 +00:00
```
2018-03-29 17:17:27 +00:00
### Linux
2018-03-29 17:17:27 +00:00
```bash
sudo apt install mono-complete nuget msbuild dotnet-sdk-3.1 # install build tools (Debian/ubuntu)
2018-03-29 17:17:27 +00:00
git clone https://github.com/Jackett/Jackett.git
cd Jackett/src
# dotnet core version
dotnet publish Jackett.Server -f netcoreapp3.1 --self-contained -r linux-x64 -c Debug # takes care of everything
./Jackett.Server/bin/Debug/netcoreapp3.1/linux-x64/jackett # run jackett
2018-12-24 12:57:33 +00:00
```
2018-03-29 17:17:27 +00:00
2017-05-04 19:55:41 +00:00
## Screenshots
2020-02-10 22:15:45 +00:00
![screenshot](https://raw.githubusercontent.com/Jackett/Jackett/master/.github/jackett-screenshot1.png)
![screenshot](https://raw.githubusercontent.com/Jackett/Jackett/master/.github/jackett-screenshot2.png)
![screenshot](https://raw.githubusercontent.com/Jackett/Jackett/master/.github/jackett-screenshot3.png)
2017-05-04 19:55:41 +00:00
[inviteneeded]: https://raw.githubusercontent.com/Jackett/Jackett/master/.github/label-inviteneeded.png