opnform-host-nginx/UPDATED_RESTART_INSTRUCTIONS.md

Updated Restart Instructions for OpnForm

Changes Made

1. Removed health check from api-nginx - This was causing the "starting" status
2. Fixed PHP-FPM health check - Changed to check process existence
3. Made services accessible externally - Changed ports from localhost-only to all interfaces

Step-by-Step Restart Process

1. Stop ALL OpnForm Containers

In your Docker web interface:

• Select ALL OpnForm containers
• Click "Stop"
• Wait for all to fully stop

2. Remove the api-nginx Container (Important!)

• Select the opnform-api-nginx container
• Click "Remove" or "Delete"
• This ensures it recreates with the new configuration

3. Start Containers in Order

Start each container and wait for it to be ready before starting the next:

1. opnform-db - Wait until "healthy"
2. opnform-redis - Wait until "healthy"
3. opnform-api - Wait until "healthy" (may take 90 seconds)
4. opnform-api-nginx - Should show "running" (no health check now)
5. opnform-api-worker - Wait until running
6. opnform-api-scheduler - Wait until running
7. opnform-client - Wait until "healthy"

4. Verify Everything Works

Check nginx is actually running:

Look at the logs for opnform-api-nginx. You should see:

Configuration complete; ready for start up

Test the services:

• UI: http://YOUR-SERVER-IP:7655
• API: http://YOUR-SERVER-IP:7654/api/health

5. If api-nginx Still Shows Issues

Check if PHP-FPM is running in the API container: