From 68e035ceb25b3333874b12895996e0e742b8dbbd Mon Sep 17 00:00:00 2001 From: Rishi Ghan Date: Fri, 17 May 2024 10:50:11 -0400 Subject: [PATCH] =?UTF-8?q?=F0=9F=90=B3=20Updated=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 24 +++++++++++++++++++----- docker-compose.env | 11 ++++++----- docker-compose.yml | 4 ++-- 3 files changed, 27 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 8ae4586..57a6728 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,7 @@ This repo contains the `docker-compose` files necessary to run: 1. ThreeTwo UI 2. `threetwo-core-service` and its dependencies 3. `threetwo-metadata-service` and its dependencies +4. `threetwo-acquisition-service` and its dependencies ### Pre-requisites @@ -24,12 +25,8 @@ You need 2 folders: ``` - comics - userdata - |- covers - |- expanded - |- temporary ``` - #### ComicVine To get ComicVine to work for metadata scraping and other functions, you _must_ have a ComicVine API key. @@ -49,12 +46,21 @@ You can get one [here.](https://comicvine.gamespot.com/api/) Metadata scraping w 1. Find the hostname of your machine and set the `UNDERLYING_HOSTNAME` to that. For e.g. `UNDERLYING_HOSTNAME=foo` 2. Set the `COMICS_DIRECTORY` and `USERDATA_DIRECTORY` to the correct _absolute_ paths 3. Set the `COMICVINE_API` to your ComicVine API key + 4. To summarize, these are the only variables you need to configure: + ``` + UNDERLYING_HOSTNAME=myhost + + COMICS_DIRECTORY=/path/to/comics + USERDATA_DIRECTORY=/path/to/userdata + + COMICVINE_API_KEY=onethreetwo + ``` 4. Save the file 5. Run the stack using: `env $(cat docker-compose.env | xargs) docker-compose up` ### Ports -1. `threetwo`, the UI runs on port `8050` +1. `threetwo`, the UI runs on port `5173` 2. `threetwo-core-service` service on `3000` 3. `threetwo-metadata-service` service on `3080` @@ -65,4 +71,12 @@ General 1. Some common problems can be traced to out-of-date images, and as such can be mitigated by simply pruning orphaned images: `docker system prune -a` 2. Always check the logs of the offending service, `docker logs --follow ` +3. Once the stack is up, assuming everything went well, look for `threetwo-ui` service's logs to see something like: + + ``` + threetwo-ui | VITE v5.2.7 ready in 145 ms + threetwo-ui | + threetwo-ui | ➜ Local: http://localhost:5173/ + threetwo-ui | ➜ Network: http://172.30.0.9:5173/ +``` diff --git a/docker-compose.env b/docker-compose.env index b3f349a..8d0c19f 100644 --- a/docker-compose.env +++ b/docker-compose.env @@ -1,10 +1,11 @@ -UNDERLYING_HOSTNAME=ghost +UNDERLYING_HOSTNAME=localhost -COMICS_DIRECTORY=/mnt/unraidshare/directconnect/downloads/comics/ -USERDATA_DIRECTORY=/home/rishi/userdata +COMICS_DIRECTORY=/path/to/comics +USERDATA_DIRECTORY=/path/to/userdata -COMICVINE_API_KEY=foobar +COMICVINE_API_KEY=onethreetwo +CACHER=Memory LOGGER=true LOGLEVEL=info SERVICEDIR=dist/services @@ -15,4 +16,4 @@ MONGO_URI=mongodb://db:27017/threetwo ELASTICSEARCH_URI=http://elasticsearch:9200 REDIS_URI=redis://redis:6379 TRANSPORTER=redis://redis:6379 -CACHER=Memory + diff --git a/docker-compose.yml b/docker-compose.yml index 8cf9ff3..8f1deb9 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -68,7 +68,7 @@ services: - zookeeper environment: name: core-services - SERVICES: api,library,jobqueue,settings,search,socket,imagetransformation,torrentjobs,opds + SERVICES: api,library,imagetransformation,opds,search,settings,jobqueue,socket,torrentjobs env_file: docker-compose.env volumes: - *comics-volume @@ -103,7 +103,7 @@ services: - proxy db: - image: "bitnami/mongodb:latest" + image: "mongo:latest" container_name: database networks: - proxy