COMA Media Server Docker Install
================================

This Docker install runs COMA Media Server and the COMA worker using the official image:

  comamediaserver/coma-media-server:1.1.0

Requirements
------------

- Docker Desktop on Windows/macOS, or Docker Engine on Linux/NAS.
- Docker Compose v2.
- Internet access on first install so Docker can pull the COMA image.

Quick Install
-------------

1. Extract this folder somewhere permanent, for example:

   Windows:
     C:\COMA-Docker

   Linux/NAS:
     /opt/coma

2. Copy `.env.example` to `.env`.

3. Edit `.env` and set `COMA_MEDIA_PATH` to your media folder.

   Examples:

   Windows Docker Desktop:
     COMA_MEDIA_PATH=D:/Media

   Linux/NAS:
     COMA_MEDIA_PATH=/mnt/media

4. Start COMA:

   docker compose up -d

5. Open:

   http://localhost:31314

Useful Commands
---------------

View status:

  docker compose ps

View logs:

  docker compose logs -f

Restart:

  docker compose restart

Stop:

  docker compose down

Update later:

  docker compose pull
  docker compose up -d

Folders
-------

The install creates/uses:

  ./config  - database, logs, backups, add-ons, settings
  ./cache   - generated playback cache, thumbnails, transcodes
  ./media   - default media folder if you do not change COMA_MEDIA_PATH

Do not delete `./config` unless you want to reset the server.

Notes
-----

- COMA does not include media content.
- You are responsible for ensuring you own or have lawful rights to any media you host, stream, or share.
- The Docker image communicates with:
    https://licensing.comamediaserver.com
    https://api.comamediaserver.com
