🐳 Updated docs

This commit is contained in:
2024-05-17 10:50:11 -04:00
parent 3633054091
commit 68e035ceb2
3 changed files with 27 additions and 12 deletions

View File

@@ -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 <servicename>`
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/
```

View File

@@ -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

View File

@@ -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