Common Issues

Find solutions to frequent setup and runtime problems.

Port Already in Use

If you see an error like "Address already in use", it means another service is using port 8080.

Solution: Change the port mapping in the docker command. 
docker run -p 9090:8080 --name local-ai-amlan -ti localai-amlan

Models Not Found

By default, models are stored inside the container and lost on restart unless you mount a volume.

Solution: Mount a local directory for persistence. 
docker run -v /path/to/models:/build/models -p 8080:8080 localai-amlan

Out of Memory (OOM)

Large models require significant RAM. If the container crashes unexpectedly.

Solution: Increase Docker's memory limit in Docker Desktop settings > Resources. Aim for at least 8GB, preferably 16GB.