GraphQL API Installation

[khaledsawan]

GraphQL API 404 Error with Bagisto Docker Installation

Environment

• Installation Method: Bagisto Docker
• Experience Level: Beginner with Docker
• Issue: GraphQL API returns 404 after installation

Problem Description

I installed Bagisto using the official Docker repository. When trying to add GraphQL API following the documentation, I encountered several issues:

1. Missing .env File: The .env file is not in /var/www/html inside the PHP-FPM container
2. File Location: The actual .env file is in the .configs folder on the host system
3. GraphQL 404 Error: After following the installation guide, accessing /graphiql returns 404

Steps to Reproduce

1. Install Bagisto via Docker: git clone https://github.com/bagisto/bagisto-docker
2. Run setup (everything works fine initially)
3. Install GraphQL API: composer require bagisto/graphql-api
4. Run installation: php artisan bagisto-graphql:install
5. Encounter database connection errors due to missing .env file
6. Copy .env from .configs folder to /var/www/html
7. Fix database connection issues
8. Access /graphiql - returns 404

Current Status

• ✅ GraphQL routes registered in php artisan route:list
• ✅ JWT secret generated successfully
• ✅ Database migrations completed
• ✅ .env file configured with GRAPHQL_ENDPOINT=http://localhost/graphql
• ❌ GraphiQL returns 404 at http://myserver:8088/graphiql

Expected Behavior

GraphQL Playground should be accessible at /graphiql endpoint

Actual Behavior

404 error when accessing /graphiql

Questions

1. Where should the .env file be located in Docker installations?
2. How should GraphQL endpoints be configured for Docker deployments?
3. Are there Docker-specific configuration steps missing from the GraphQL API documentation?
4. Why does GraphiQL return 404 even though routes are registered?

Additional Context

• Using default Bagisto Docker configuration

• GraphQL routes show as registered:

• Tried clearing caches, restarting containers, and verifying configurations

Looking for guidance on Docker-specific setup for GraphQL API. Thank you!