Getting Started

Getting Started

🌐 English · Deutsch

1. First-time setup (setup token)

On the very first start no admin account exists yet. The app generates a one-time setup token (valid for 30 minutes) and prints it to the terminal or Docker log:

========================================================================
  ERSTEINRICHTUNG — Noch kein Admin-Konto vorhanden.
  Setup-Token: <token>
  Lokale Installation:
  Öffne http://localhost:<PORT>/setup?token=<token> im Browser.
  Docker Installation:
  Öffne http://<DockerHostIP>:<HostPort>/setup?token=<token> im Browser.
  Standardport ist 8080
  Der Token ist 30 Minuten gültig. Danach App neu starten.
========================================================================

On the setup page you choose username, password (min. 8 characters) and UI language (German/English). The first user automatically becomes admin.

Alternative for Docker/automation: With the environment variables MEDIAFORGE_WEB_ADMIN_USER and MEDIAFORGE_WEB_ADMIN_PASS the admin account is created automatically on first start and the setup page is skipped.

2. Check the basic settings

Under Settings (gear icon in the sidebar, admins only) you should set first:

• Download path — defaults to ~/Downloads
• Default language — e.g. German Dub
• Default provider — e.g. VOE

All settings are stored in the database; a .env file is no longer needed (details: Configuration).

3. First download

1. Type a title into the search bar on the home page. The source selector switches between AniWorld (anime), serienstream.to (series) and FilmPalast (movies).
2. Click a result — seasons and episodes are loaded.
3. Select episodes, pick language and provider, optionally a custom target path.
4. Hit Download — the job is placed in the queue (sidebar button "Queue").

The queue processes one download after another. Progress, speed and errors are visible live in the queue view (Download System).

4. Captcha?

Some hosts occasionally show a captcha. The app opens an invisible browser internally and embeds the captcha directly in the WebUI — solve it with a click and the download continues automatically.

5. What next?

• Set up AutoSync so new episodes download automatically
• Enable Notifications (Telegram, Discord, …)
• Connect Integrations with Jellyfin/Plex or Overseerr/Jellyseerr
• Explore the Library — including the in-browser player