Docker/AdventureLog
Docker/AdventureLog
1
0
Fork 0
mirror of https://github.com/seanmorley15/AdventureLog.git synced 2025-07-19 12:59:36 +02:00
Code Issues Releases Activity

Migration to new documentation and information site

Browse source
This commit is contained in:
Sean Morley 2024-11-26 10:31:25 -05:00
parent 8e5a20ec62
commit 17d8784d8c
59 changed files with 1967 additions and 11276 deletions
Download patch file Download diff file Expand all files Collapse all files

41
documentation/docs/troubleshooting/nginx_failed.md Normal file
View file

@ -0,0 +1,41 @@
# Troubleshooting: `Starting nginx: nginx failed!` in the Backend Container
The AdventureLog backend container uses a built-in Nginx container with a built-in nginx config that relies on the name `server` to be the service name of the backend container. If the Nginx service fails to start in the backend container, the whole backend service will keep restarting and fail to start.
**The primary reason for this error is changing the backend service name `server` to something different**
If you're experiencing issues with the Nginx service failing to start in the backend container, follow these troubleshooting steps to resolve the issue.
### 1. **Check the `server` Service Name**:
- Verify that the service name of the backend container is set to `server` in the `docker-compose.yml` file.
- The service name should be set to `server` in the `docker-compose.yml` file. For example:
```yaml
server:
image: ghcr.io/seanmorley15/adventurelog-backend:latest
container_name: adventurelog-backend
```
### 2. **To keep the backend service name different**:
- If you want to keep the backend service name different from `server`, you can mount a custom Nginx configuration file to the backend container.
- Get the default Nginx configuration file from the AdventureLog repository:
```bash
wget https://raw.githubusercontent.com/seanmorley15/AdventureLog/refs/heads/main/backend/nginx.conf
```
- Update the `nginx.conf` file to replace all occurrences of `server` with your custom service name.
- Mount the custom Nginx configuration file to the backend container in the `docker-compose.yml` file. For example:
```yaml
server:
image: ghcr.io/seanmorley15/adventurelog-backend:latest
container_name: adventurelog-backend
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf
```
### 3. **Restart the Backend Container**:
These steps should help you resolve the issue with the Nginx service failing to start in the backend container. If you continue to face issues, please reach out to the AdventureLog community on Discord or GitHub for further assistance.