FrederikBaerentsen/ComicOPDS
1
1
Fork 1
Code Issues 6 Pull Requests Packages Projects Releases 1 Wiki Activity

Update docs/troubleshooting.md

Browse Source 
Added info about http
This commit is contained in:
FrederikBaerentsen
2025-09-15 21:29:41 +02:00
parent 966104290e
commit ae0cdcb682
1 changed files with 59 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files

118
docs/troubleshooting.md
View File

@@ -1,59 +1,59 @@
## 🛠️ Troubleshooting ## 🛠️ Troubleshooting
> Access logs are disabled in the docker image. Enable them by removing `--no-access-log` from the `CMD` command in the Dockerfile. > Access logs are disabled in the docker image. Enable them by removing `--no-access-log` from the `CMD` command in the Dockerfile.
### Common Issues ### Common Issues
#### No Comics Appearing #### No Comics Appearing
- **Check mount**: Ensure your comics folder is mounted at `/library` - **Check mount**: Ensure your comics folder is mounted at `/library`
- **File format**: Only `.cbz` files are supported - **File format**: Only `.cbz` files are supported
- **Metadata**: Ensure CBZ files contain `ComicInfo.xml` - **Metadata**: Ensure CBZ files contain `ComicInfo.xml`
- **Permissions**: Verify read permissions on comic files - **Permissions**: Verify read permissions on comic files
#### Missing Thumbnails #### Missing Thumbnails
- **First load**: Thumbnails generate on first request - **First load**: Thumbnails generate on first request
- **Check permissions**: Ensure `/data/thumbs` is writable - **Check permissions**: Ensure `/data/thumbs` is writable
- **View errors**: Check error log via dashboard or `/data/thumbs_errors.log` - **View errors**: Check error log via dashboard or `/data/thumbs_errors.log`
#### Authentication Problems #### Authentication Problems
- **Verify credentials**: Check `OPDS_BASIC_USER` and `OPDS_BASIC_PASS` - **Verify credentials**: Check `OPDS_BASIC_USER` and `OPDS_BASIC_PASS`
- **Client support**: Ensure your client supports HTTP Basic Auth - **Client support**: Ensure your client supports HTTP Basic Auth
- **Disable auth**: Set `DISABLE_AUTH=true` for testing - **Disable auth**: Set `DISABLE_AUTH=true` for testing
#### Wrong Links/URLs #### Wrong Links/URLs
- **Behind proxy**: Set `SERVER_BASE` and `URL_PREFIX` correctly - **Behind proxy**: Set `SERVER_BASE` and `URL_PREFIX` correctly
- **Protocol mismatch**: Ensure HTTP/HTTPS consistency - **Protocol mismatch**: Ensure HTTP/HTTPS consistency (see [Notes on Clients and HTTPS](docs/clients.md#notes-on-clients-and-https) for more)
#### Scan starts by itself: #### Scan starts by itself:
- `AUTO_INDEX_ON_START`: "false" - `AUTO_INDEX_ON_START`: "false"
### Debug Commands ### Debug Commands
> Access logs are disabled in the docker image. Enable them by removing `--no-access-log` from the `CMD` command in the Dockerfile. > Access logs are disabled in the docker image. Enable them by removing `--no-access-log` from the `CMD` command in the Dockerfile.
```bash ```bash
# View container logs # View container logs
docker compose logs -f comicopds docker compose logs -f comicopds
# Check container health # Check container health
docker compose ps docker compose ps
# Inspect configuration # Inspect configuration
docker compose exec comicopds env | grep -E "(SERVER_BASE|URL_PREFIX|CONTENT_BASE_DIR)" docker compose exec comicopds env | grep -E "(SERVER_BASE|URL_PREFIX|CONTENT_BASE_DIR)"
# Test internal connectivity # Test internal connectivity
docker compose exec comicopds wget -qO- http://localhost:8080/healthz docker compose exec comicopds wget -qO- http://localhost:8080/healthz
# Check FTS5 availability # Check FTS5 availability
curl -u admin:password http://localhost:8382/debug/fts curl -u admin:password http://localhost:8382/debug/fts
``` ```
### Log Files ### Log Files
- **Application logs**: `docker compose logs -f` - **Application logs**: `docker compose logs -f`
- **Thumbnail errors**: `/data/thumbs_errors.log` - **Thumbnail errors**: `/data/thumbs_errors.log`
### Performance Tuning ### Performance Tuning
- **Large libraries**: Disable `AUTO_INDEX_ON_START` - **Large libraries**: Disable `AUTO_INDEX_ON_START`
- **Slow thumbnails**: Increase `THUMB_WORKERS` - **Slow thumbnails**: Increase `THUMB_WORKERS`
- **Memory usage**: Reduce `PAGE_SIZE` - **Memory usage**: Reduce `PAGE_SIZE`
- **Network issues**: Check `SERVER_BASE` configuration - **Network issues**: Check `SERVER_BASE` configuration