From 2ad8d04c9961922a21d43ffb74d26cdf6e16b13d Mon Sep 17 00:00:00 2001 From: Enstrayed <48845980+Enstrayed@users.noreply.github.com> Date: Tue, 22 Apr 2025 09:22:54 -0700 Subject: [PATCH] readme will need rewritten later --- README.md | 53 ++--------------------------------------------------- 1 file changed, 2 insertions(+), 51 deletions(-) diff --git a/README.md b/README.md index f3b9c36..903d3f7 100644 --- a/README.md +++ b/README.md @@ -8,49 +8,12 @@ This file contains documentation relevant for development and deployment, but no If you would like to report a bug or security issue, please open a GitHub issue. If you are the operator of a service this application accesses, use the contact information provided during registration with your service to contact me directly. ## Configuration -The configuration is downloaded from CouchDB on startup, however two environment variables must be set to specify the URL of the CouchDB server and the credentials for accessing it: -| Variable | Required? | Purpose | -|--------------|----------------------|-----------------------------------------------------------------------------------------------------| -| `API_PORT` | No, defaults to 8081 | Sets the port the server will listen on | -| `API_DBHOST` | Yes | Complete URL of the CouchDB instance, including port and protocol | -| `API_DBCRED` | Yes | Credentials to access the CouchDB instance, in Basic Authentication format e.g. `username:password` | -
Configuration Example -* `frontpage.directory`: Directory of frontpage, will be served at root with modifications. -* `mailjet.apiKey`: Mailjet API Key. -* `mailjet.senderAddress`: Email address that emails will be received from, must be verified in Mailjet admin panel. -* `nowplaying.*.apiKey`: API key of respective service. -* `nowplaying.*.target`: User that should be queried to retrieve playback information. +
Configuration Template ```json -{ - "frontpage": { - "directory": "" - }, - "mailjet": { - "apiKey": "", - "senderAddress": "" - }, - - "nowplaying": { - "lastfm": { - "apiKey": "", - "target": "" - }, - "jellyfin": { - "apiKey": "", - "host": "", - "target": "" - }, - "cider": { - "apiKeys": [], - "hosts": [] - } - } - -} ```
@@ -58,9 +21,6 @@ The configuration is downloaded from CouchDB on startup, however two environment ## Docker In production, this application is designed to be run in Docker, and the container built by pulling the latest commit from the main branch. As such, deploying this application is just a matter of creating a directory and copying the Dockerfile: -> [!IMPORTANT] -> Please review the Configuration section of this document for important information. By default, the `config.json` file is expected to be mounted into the container at `/app/config.json`. - ```dockerfile FROM node:22 WORKDIR /app @@ -75,16 +35,7 @@ ENTRYPOINT [ "node", "index.js" ]
Docker Compose File ```yaml ---- -services: - enstrayedapi: - build: - context: . - image: enstrayedapi - container_name: enstrayedapi - restart: unless-stopped - volumes: - - ./config.json:/app/config.json + ```