Need Help?

Need help to install or setup this app? We are available on:

Discord

Setting Up Plex

Setting Up Plex on Nébulaura

Plex Media Server allows you to aggregate all your personal media and access it from anywhere.

Upgrading Plex

To upgrade your Plex instance:

  1. Log in to the web UI/dashboard provided for your service.
  2. Navigate to the Service Info section.
  3. Click Restart next to Plex. This will restart the app and check for updates.

Note: Updates are typically available 2-3 days after official release.

Initial Setup

First, connect to your slot via SSH. If you need help connecting to the server, refer to the relevant help article.

To install Plex, run the following command:

box install plex

After issuing this command, you’ll see the following notice:

Visit https://www.plex.tv/claim, log in, copy your Plex claim token to your clipboard, and paste it here. This will automatically claim your server. Please note, you will be unable to tunnel to your slot later if you do not claim it now.

Claiming your server during installation simplifies the setup process. If you skip this step, you can claim it manually later.

Claim Token Tip

  • On Windows (using PuTTY), you can paste with a right-click.
  • On Linux, use Control-Shift-V to paste.

Once installation is complete, you’ll see a notice with the application’s access URL (e.g., https://app02.hostingby.design:7777/web).

How to Access

Plex is accessible through the port assigned during installation. For example:

https://<serverhostname.io>:<port>/web

If you forgot your personalized port, use the following commands:

  • View your Plex link on the dashboard.
  • Rediscover your port programmatically: 
    cat ~/.install/.plex.lock

If your server is claimed, you can also view it via the Plex Web dashboard at https://app.plex.tv/dashboard.

Service Management

As with all Nébulaura-configured applications, Plex can be managed via SSH using the following commands:

  • Status: Check the current status of Plex.
  • Start: Start the Plex service.
  • Stop: Stop the Plex service.
  • Restart: Restart the Plex service.
  • Enable: Configure Plex to start automatically at boot.
  • Disable: Prevent Plex from starting at boot.

Example:

box start plex

Configuration

⚠️ Caution
You are free to change most settings under the server configuration. However, avoid modifying:

  • Plex remote port
  • Manual port mapping mode (under "Remote Access" settings)

Changing these settings may cause you to lose access to your Plex instance.

Libraries

During setup, Plex automatically configures two media libraries:

  • TV Shows: ~/media/TV Shows
  • Movies: ~/media/Movies

If you need a custom folder for your library (e.g., using rclone or plexdrive), your entire home directory is mounted under the /data folder in Plex.

Manual Claiming

If you skipped claiming your Plex server during installation, you can do it manually by creating an SSH tunnel to your server. This allows your connection to appear as if it’s on the same network as your Plex instance.

SSH Tunnel Setup

Windows (PuTTY)

  1. Open PuTTY and enter your server hostname (e.g., yourhostname.ltd).
  2. Navigate to Connection > SSH > Tunnels on the left menu.
  3. Configure the tunnel:
    • Source Port: 8888
    • Destination: localhost:<plex-port>
  4. Click Add and then Open.
  5. Log in with your username and password.
  6. Once connected, open your browser and navigate to: 
    http://localhost:8888/web

Your browser will connect to the Plex server and allow you to claim the unclaimed instance.

Connecting to Other Clients

To link Plex to other applications like Sonarr or Tautulli, use the following details:

  • Host: 127.0.0.1
  • Port: <your plex port>

Organize and Stream with Plex

With Plex on Nébulaura, you can effortlessly organize your media and access it anytime, anywhere. Set it up today for a seamless entertainment experience.