Logitech Media Server 8.5.2 - Generic build and installation notes
==================================================================

Source package:
  logitechmediaserver-8.5.2.tar.gz

SHA-256 checksum:
  6de4ac0e100707127acf7adaf60ce38142ba313937b00ba5b535e3ee883ebc42

To check the downloaded file, run:
  sha256sum logitechmediaserver-8.5.2.tar.gz

The command output must start with the SHA-256 checksum shown above.

This archive contains the upstream/default Logitech Media Server source for
version 8.5.2.

Important notes
---------------
- Logitech Media Server is primarily a Perl application.
- A normal installation is usually done from an LMS package prepared for the
  target operating system, for example a Debian .deb package.
- The source archive can also be unpacked and run directly for inspection,
  development, or validation, provided the required Perl modules and runtime
  dependencies are available.
- Exact packaging steps depend on the target distribution, Perl version and
  packaging policy.

Extract the source
------------------

  tar -xzf logitechmediaserver-8.5.2.tar.gz
  cd slimserver-8.5.2

Prepare dependencies
--------------------

On a Debian-based system, install the LMS runtime/build dependencies required by
that distribution. The exact package list depends on the target release, but it
normally includes Perl and common Perl modules, database support, audio metadata
libraries and system service tooling.

Example high-level preparation flow on a Debian-based system:

  sudo apt-get update
  sudo apt-get install perl adduser libio-socket-ssl-perl libnet-ssleay-perl \
    libcrypt-openssl-rsa-perl libcrypt-openssl-bignum-perl \
    libcrypt-openssl-random-perl libdigest-sha-perl libjson-xs-perl \
    libxml-parser-perl libdbi-perl libdbd-sqlite3-perl libhtml-parser-perl \
    libtemplate-perl libyaml-libyaml-perl libsub-name-perl \
    libclass-xsaccessor-perl libev-perl libio-aio-perl liblinux-inotify2-perl \
    libimage-scale-perl libaudio-scan-perl

Optional audio/transcoding tools commonly used with LMS:

  sudo apt-get install flac lame sox faad wavpack

Run from source for validation
------------------------------

After installing the required dependencies, LMS can be started from the extracted
source tree for validation/development purposes:

  perl slimserver.pl --help
  perl slimserver.pl --prefsdir /tmp/lms-prefs --cachedir /tmp/lms-cache

Then access the LMS web interface from a browser, usually on port 9000:

  http://<target-host>:9000/

Package-based installation
--------------------------

For a system installation, prepare or obtain an LMS package suitable for the
target distribution. On Debian-based systems this is normally installed with
`dpkg` or `apt`.

Example package replacement flow on a compatible system:

  sudo systemctl stop logitechmediaserver
  sudo dpkg -i logitechmediaserver_8.5.2*.deb
  sudo apt-get -f install
  sudo systemctl daemon-reload
  sudo systemctl start logitechmediaserver

Verify the service
------------------

  systemctl status logitechmediaserver
  journalctl -u logitechmediaserver --no-pager

Typical paths
-------------

Common Debian-style paths include:

  /usr/share/squeezeboxserver
  /etc/squeezeboxserver
  /var/lib/squeezeboxserver
  /var/log/squeezeboxserver

Backup before replacement
-------------------------

Before replacing an existing LMS installation, backup user data such as:

  /var/lib/squeezeboxserver/prefs
  /var/lib/squeezeboxserver/cache
  /var/lib/squeezeboxserver/Plugins
  /etc/squeezeboxserver