📘

cross-seed

The scripts and documents shared here are provided as-is by fellow customers. Ultra.cc does not review, test, or endorse these contributions. Their inclusion does not imply fitness for any particular purpose, nor guarantee compliance with our Terms of Service. No official support is provided for their use. You assume all risk in using them.

This guide walks you through installing cross-seed using the source build method on your Ultra.cc slot. This script is provided by the developer.

Prerequisites

Python: Version 3.10 or newer
Node.js: Version 22 LTS (latest LTS release)

Features

Automatic Cross-Seeding: Scans your existing torrents and searches indexers for matches, enabling you to cross-seed with minimal effort.
Flexible Matching: Offers multiple matching modes (strict, flexible, partial) to suit your accuracy and performance preferences.
Client Integration: Injects matched torrents directly into your supported torrent client, streamlining the seeding process.

Installation

Connect to your Ultra service via SSH.
Install the latest version of Node.js LTS (v22.x)

bash <(wget -qO- https://scripts.ultra.cc/util-v2/LanguageInstaller/Node-Installer/main.sh)

Install Python v3.10+ (recommended to run 3.10 unless another version is specifically needed):

bash <(wget -qO- https://scripts.ultra.cc/util-v2/LanguageInstaller/Python-Installer/main.sh)

Log out of your SSH session and log back in, or restart your terminal. This ensures Python and Node are available in your environment.
Install cross-seed using the script provided by the developer specifically for the Ultra environment:

bash <(wget -qO- https://raw.githubusercontent.com/zakkarry/cross-seed-source-build/refs/heads/master/install_shared_env_xs.sh)

Follow the prompts in the script. Each install option includes a brief description to help you choose the best version.

Configuration

Once successfully installed, you need to generate a configuration file.
Run the following command to generate a config.js

cross-seed gen-config

You will need to generate an API key and copy it into your config.js using:

cross-seed api-key

You will need to edit the config.js by using nano

nano /.cross-seed/config.js

You will need to add all your URLs for applications, like Prowlarr Torznab URLs, Jackett RSS Feeds, *Arr apps, and Download Clients in your config.js
Ensure you configure your dataDirs with the download directory of your torrent client.
(Optional) If you want, you can change matching flexibility, but flexible is recommended.
For further configuration and customization, please refer to the official documentation. Or the links displayed at each option in config.js

Usage

Once you have configured config.js to your liking, with your applications added, (you will specifically need a download client and at least one indexing application added e.g. qBittorrent and Prowlarr), you can watch as cross-seed does it’s magic.
There are other options for managing your application via the official documentation.

Notes

You must restart your terminal session after installing Node and Python for the environment to be recognized any time you change them.
You can rerun the install_shared_env_xs.sh script to upgrade or reconfigure your cross-seed install.
The daemon method is not recommended on Ultra due it being unauthenticated which could lead to security concerns.

If you require further assistance, you can open a support ticket here!

Feedback and suggestions regarding this article are welcome on our Discord server

cross-seed
Prerequisites
Features
Installation
Configuration
Usage
Notes