LAN WiFi

Zero-install access. Auto-detect server presence. WiFi file sharing.

Server Detection

Plexarr is designed to be accessed from any device on your local network. No client installation is required. The server runs on Linux Mint and binds to all interfaces by default.

radar Detect Server on This Network

NOT CHECKED

Your IP: --

Server URL: --

Status: help

tips_and_updates How it works

The browser attempts to reach http://your-ip:8080/health. If the server responds, it is online. If not, the page checks whether your current IP is in a private LAN range (192.168.x, 10.x, 172.16-31.x). Use this page to confirm your server is reachable before opening the main UI.

WiFi File Sharing

Upload files from any device on the same WiFi network directly into your Plex library folders. No USB cables, no cloud storage, no port forwarding. Files are auto-categorized and renamed into Plex format automatically.

How It Works — Two Modes

Mode 1: Manual Upload with Destination

Open the Plexarr web UI on your phone, tablet, or laptop.
Navigate to the Files tab.
Drag and drop files into the upload zone, or click Browse to select them.
Choose the destination: TV Shows, Movies, Anime, Music, or Downloads.
Toggle Auto Sort if you want the renamer to process the file immediately.
The server receives the file over HTTP and places it in the correct path.

Mode 2: WiFi Auto-Categorize Upload (Recommended)

From any device on the same WiFi network, POST files to /api/upload/wifi.
No destination selection needed. The server detects the media type automatically.
Files are saved to a staging area, then auto-categorized and renamed into Plex format.
TV episodes go to TV Shows/Name/Season/Name - S01E02.ext.
Movies go to Movies/Name (Year)/Name (Year).ext.
Anime goes to Anime/Name/Season/Name - S01E02.ext.
Music goes to Music/Artist/Album/Track.ext.

API: WiFi Upload

POST /api/upload/wifi
Content-Type: multipart/form-data

file: [binary]
file: [binary]  # multiple files supported

Response includes the final Plex path, detected media type, and file size for each uploaded file. Errors (wrong extension, size limit) are reported per file without stopping the whole batch.

Check Upload Status

GET /api/upload/wifi/status

Returns max upload size, allowed extensions, and the server URL to use for uploads.

Requirements

Server and client must be on the same network (WiFi or Ethernet).
Server firewall must allow port 8080 (or your configured port).
Upload size limit defaults to 5 GB per file. Increase in config if needed.
Supported formats: .mkv, .mp4, .avi, .mov, .m4v, .ts, .mp3, .flac, .aac, .m4a, .ogg, .wav.

Security

warning LAN Only

WiFi sharing is designed for trusted local networks. Do not expose port 8080 to the internet without HTTPS and authentication. Use a VPN or reverse proxy for remote access.

Client / Server Topology

                    [ WiFi Router / LAN ]
                           |
        +------------------+------------------+
        |                  |                  |
   +----v----+       +----v----+       +----v----+
   | Phone   |       | Laptop  |       | Server  |
   | (iOS)   |       | (Win)   |       | (Linux  |
   |         |       |         |       | Mint)   |
   +----+    |       +----+    |       +----+    |
        |                  |                  |
        |   HTTP 8080      |   HTTP 8080      |
        +------------------+------------------+
                             |
                        +----v----+
                        | Plexarr |
                        | Flask   |
                        | Server  |
                        +----+    |
                             |
                        +----v----+
                        | Plex    |
                        | Library |
                        | Folders |
                        +---------+

Access URLs

Device	URL Format	Example
Same machine	`http://localhost:8080`	http://localhost:8080
Local WiFi	`http://server-ip:8080`	http://192.168.1.50:8080
VPN / Tailscale	`http://tailscale-ip:8080`	http://100.x.x.x:8080

Troubleshooting LAN Access

Problem	Solution
Connection refused	Check server is running. Verify firewall: `sudo ufw allow 8080/tcp`
Page loads but no data	Ensure server is bound to 0.0.0.0, not 127.0.0.1
Uploads timeout	Increase Flask timeout or use a reverse proxy with chunked encoding
Phone cannot connect	Verify phone and server are on same WiFi subnet. Check router isolation settings.
Firewall blocks	Check iptables/ufw. Temporarily disable for testing: `sudo ufw disable`

arrow_back Setup Docs Overview arrow_forward