Database
Laravel 8
Laravel 9
Laravel 10
Laravel 11
Laravel 12
Laravel Database Connection Refused Error - Fix
This error occurs when Laravel cannot establish a connection to the database server.
The Error
Error Message
SQLSTATE[HY000] [2002] Connection refusedCommon Causes
- 1 Database server not running
- 2 Incorrect database host in .env
- 3 Wrong port number
- 4 Firewall blocking connection
- 5 Docker networking issues
Solutions
1
Check if database service is running
Bash
# For MySQL
sudo systemctl status mysql
# For PostgreSQL
sudo systemctl status postgresql
2
Verify .env database configuration
ENV
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password
3
Clear configuration cache
Bash
php artisan config:clear
php artisan cache:clear
4
For Docker, use container name as host
ENV
DB_HOST=mysql
# or
DB_HOST=host.docker.internalNeed Help With Your Laravel Project?
I specialize in building custom Laravel applications, process automation, and SaaS development. Whether you need to eliminate repetitive tasks or build something from scratch, let's discuss your project.
About Hafiz
Senior Full Stack Developer. I build production software with Laravel, Filament, Vue, and AI integrations, and write about the real decisions behind shipping it.
Get in touch →