Import from other apps

Bring your old apps’ setup into HolyArrs without typing it again.

HolyArrs only reads the old apps. Nothing in them changes, and your media files never move.

Before you start

• Sign in as the owner or an admin.
• Have each old app’s address and API key ready.
• Make sure HolyArrs can see your media folders. See Folders and hardlinks.

Import your setup

1. Open Settings > Import from other apps. You should see four steps in a row at the top.
2. Read your apps: click Add an app for each old app. You should see each app listed with a switch.
3. What to import: turn on the groups you want to bring over.
4. Import: HolyArrs checks what will be added first. Nothing changes yet. Answer any row under Needs a choice, then click Import and confirm. You can leave the page while it runs.
5. Done: you should see the results per group and Undo this import.

Keys and passwords never come over. See After the import.

Order to do it

Order	App	Why this order
1	Radarr, Sonarr	Library folders and titles come first. See Sonarr and Radarr.
2	Lidarr, Prowlarr, Bazarr	Music, Sources and subtitle languages. See Lidarr, Bazarr and Prowlarr.
3	qBittorrent, SABnzbd	Downloaders. Read them in the same import as the apps above.
4	Seerr, Overseerr	People and requests, matched to titles already here. See Request apps.

You can read every app and import them all at once. The order matters only if you import in batches.

After the import

Each item below comes over paused or off. Type its secret, check it, then turn it on.

Item	Where	What to do
Sources	Settings > Sources	Type the key, then resume.
Downloaders	Settings > Downloaders	Type the password or key, then resume.
Alerts	Settings > Alerts	Type the link or mail password, then turn on.
Outside lists	Settings > Outside lists	Check folder and Pick rules, then turn on. A Trakt list needs your Trakt key first.
People	Settings > Users and roles	Send invites.

A Source, Downloader or Alert that had tags in the old app now serves every title of its kind. Check it before you turn it on.

Sources and Downloaders arrive with May reach the local network off. Turn it on only for one on your home network. Link-local and cloud metadata addresses stay blocked either way.

To type many keys at once, see Import keys from a file.

What stays behind

• Media files. The import never moves, renames, copies or deletes a file.
• Keys, passwords, tokens and cookies. The Import step and the report list each under Keys to type again.
• Settings with no match here. Each one is on the not imported list with its reason.
• History. The old apps’ history is not read. The person who asked for a title does come over.

If it does not work

Symptom	Cause	Fix
Titles show as not found	Their folder does not match a Library folder here.	Add a path rule under Advanced in What to import, then import again.
Import says something changed	Something changed since the check.	HolyArrs checks again by itself. Look over the list, then import.
The Import button is greyed out	A person needs a choice, or HolyArrs is in safe mode.	Read the text next to the button.
Some items failed	For example, the metadata server was down.	Wait, then import again. Your old-app keys are kept.

For experts

Import again, undo, parts and safe mode

Import again. An import remembers what it added. Importing again adds only what is new and says already here for the rest. One import or undo runs at a time. If HolyArrs stops mid-import, the import is marked failed at the next start, or resumes if its job is still queued. It never blocks the next import.

Earlier imports, under the reads, lists every import and its state. Open shows an import at step 4, or step 3 while it runs.

Undo. Click Undo this import at step 4 (for an older import, Open it first). The undo runs in the background and removes only what that import added, newest first:

• titles leave the Library; their files stay where they are,
• Sources, Downloaders, Alerts, subtitle sites, people, requests and Never-add entries it added are removed,
• Outside lists it added are removed while still paused,
• naming, default subtitle languages and waits on Pick rules go back to what they were.

What you set up or changed after the import stays, and the undo report lists it: a secret you typed, a person or Outside list you turned on, naming, languages or waits you changed. Library folders that held titles stay, because the removed titles keep their History.

Parts. A part that is off is left out. Movies off: no movie folder, movie or Outside list. Subtitles off: no subtitle setting. Requests off: no requests.

Safe mode. You can read your apps and pick what to import, but not import or undo.

API

API keys need the admin scope.

Route	What it does
POST /api/v1/migrate/plan	The plan for the picked reads, with counts and suggested path rules.
POST /api/v1/migrate/dry-run	The test report and its plan_hash. Nothing changes. A person who needs a choice has choose set to same_name, numeric_id or merge_gone.
POST /api/v1/migrate/moves	Starts an import. Needs the test’s plan_hash. Answers 409 when the plan changed.
GET /api/v1/migrate/moves	Lists imports, newest first.
GET /api/v1/migrate/moves/{id}	One import, its report and progress.
GET /api/v1/migrate/moves/{id}/report	The report as a Markdown file.
POST /api/v1/migrate/moves/{id}/undo	Queues the undo (202). Follow it with GET /api/v1/migrate/moves/{id}.

Body of plan, dry-run and moves (moves also take "plan_hash"):

{
  "snapshots": [1, 2],
  "path_rules": [{"from": "/data/media/movies", "to": "/movies"}],
  "skip": ["alerts"],
  "people": {"person:seerr:1": "owner", "person:seerr:3": "admin", "person:seerr:2": "merge"}
}

A person choice is owner (old app’s owner only), admin, merge or skip. Groups you can skip: folders, pick_rules, titles, never_add, outside_lists, sources, downloaders, naming, subtitles, people, wishlist, alerts.

Pages in this section

Page	Use it to
Sonarr and Radarr	Bring over folders, shows, movies and their rules. Do this first.
Lidarr, Bazarr and Prowlarr	Bring over music, subtitle languages and Sources.
Seerr and Overseerr	Bring over people and open requests.
Read your old apps	See exactly what HolyArrs reads and keeps.
Import keys from a file	Type many keys at once.

Related

• First run
• Glossary