Skip to content
Jane Davis edited this page Jun 15, 2025 · 5 revisions

Welcome to the GNUPlex wiki!

Basic command usage

  • Install GNUPlex: sh <(curl -sL https://gnuplex.janie.page/install.sh)
  • Update GNUPlex: gnuplex -upgrade

To use GNUPlex

Navigate to http://localhost:40000/ to access a local GNUPlex installation. Use the "Manage Library" panel to add local directories to your library and specify file extensions to exclude.

Deploying a persistent media server

To run GNUPlex persistently on a Linux computer:

  1. Create a new desktop user gnuplex.
  2. Set the gnuplex user to auto-login.
  3. As the gnuplex user, run systemctl --user enable --now gnuplex after installing GNUPlex.
  4. Install Caddy.
  5. Update /etc/caddy/Caddyfile to be the following, adjusting http://gnu.plex as needed.
{
        admin off
}

http://gnu.plex {
        reverse_proxy localhost:40000
}
  1. Run sudo systemctl restart caddy.

Now, if you have a local DNS entry gnu.plex that points to your media server, you can navigate to http://gnu.plex on your local network!

Clone this wiki locally