Troubleshooting

Database Connection Issues

• Ensure MySQL/MariaDB is running and accessible from the container
• Check database credentials in environment variables
• Verify database and user exist with proper permissions
• Check network connectivity between container and database
• Ensure the database name matches exactly (case-sensitive on some systems)

Application Not Starting

• Check container logs: docker logs ipam
• Verify all required environment variables are set
• Ensure port 5000 is not already in use
• Check that MySQL/MariaDB is reachable

Subnet or IP Not Appearing

• Verify CIDR notation is correct (supports /24 to /32)
• Check subnet was created successfully (view in Admin page)
• Ensure you're logged in with appropriate permissions
• Check application logs for errors

Device IP Assignment Issues

• Verify the IP address is available (not already assigned)
• Check that the IP is not in a DHCP pool range
• Ensure the device exists and is visible in the Devices list