Replit database

PostgreSQL Connection Refused on Replit

Your application fails to connect to PostgreSQL with a connection refused error. The database service is either not running or your connection string is incorrect.

Replit's PostgreSQL requires the correct credentials, port, and hostname which vary between development and production.

Error Messages You Might See

org.postgresql.util.PSQLException: Connection refused (Connection refused) FATAL: password authentication failed for user FATAL: database does not exist
org.postgresql.util.PSQLException: Connection refused (Connection refused)FATAL: password authentication failed for userFATAL: database does not exist

Common Causes

  1. PostgreSQL service not started in Replit
  2. Wrong hostname (localhost vs network hostname)
  3. Incorrect port number in connection string
  4. Missing or wrong database credentials
  5. Database doesn't exist yet (migration not run)

How to Fix It

Verify PostgreSQL is running via Replit's database panel. Use the auto-generated connection string from Replit secrets. For Spring Boot, ensure spring.datasource.url, username, and password are correctly set. Run database migrations on first deploy using Flyway or Liquibase.

Real developers can help you.

Taufan Taufan I’m a product-focused engineer and tech leader who builds scalable systems and turns ideas into production-ready platforms. Over the past years, I’ve worked across startups and fast-moving teams, leading backend architecture, improving system reliability, and shipping products used by thousands of users. My strength is not just writing code — but connecting product vision, technical execution, and business impact. Bastien Labelle Bastien Labelle Full stack dev w/ 20+ years of experience Meïr Ankri Meïr Ankri Full-stack developer specializing in React / Next.js / Node.js with 6+ years of experience. I've worked across various sectors including automotive (Reezocar/Société Générale), healthcare (Medical Link SaaS), and e-commerce (Glasman). I build web apps end-to-end, from architecture to production, with a focus on scalability, performance, and code quality. I also mentor junior developers and contribute to technical decisions and code reviews. Prakash Prajapati Prakash Prajapati I’m a Senior Python Developer specializing in building secure, scalable, and highly available systems. I work primarily with Python, Django, FastAPI, Docker, PostgreSQL, and modern AI tooling such as PydanticAI, focusing on clean architecture, strong design principles, and reliable DevOps practices. I enjoy solving complex engineering problems and designing systems that are maintainable, resilient, and built to scale. Franck Plazanet Franck Plazanet I am a Strategic Engineering Leader with over 8 years of experience building high-availability enterprise systems and scaling high-performing technical teams. My focus is on bridging the gap between complex technology and business growth. Core Expertise: 🚀 Leadership: Managing and coaching teams of 15+ engineers, fostering a culture of accountability and continuous improvement. 🏗️ Architecture: Enterprise Core Systems, Multi-system Integration (ERP/API/ETL), and Core Database Structure. ☁️ Cloud & Scale: AWS Expert; architected systems handling 10B+ monthly requests and managing 100k+ SKUs. 📈 Business Impact: Aligning tech strategy with P&L goals to drive $70k+ in monthly recurring revenue. I thrive on "out-of-the-box" thinking to solve complex technical bottlenecks and am always looking for ways to use automation to improve business productivity. Jared Hasson Jared Hasson Full time lead founding dev at a cyber security saas startup, with 10 yoe and a bachelor's in CS. Building & debugging software products is what I've spent my time on for forever PawelPloszaj PawelPloszaj I'm fronted developer with 10+ years of experience with big projects. I have small backend background too BurnHavoc BurnHavoc Been around fixing other peoples code for 20 years. Nam Tran Nam Tran 10 years as fullstack developer Antriksh Narang Antriksh Narang 5 years+ Experienced Dev (Specially in Web Development), can help in python, javascript, react, next.js and full stack web dev technologies.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

How do I start PostgreSQL on Replit?

PostgreSQL auto-starts. Click the Database tab to verify it's running

Where's my PostgreSQL connection string?

In Replit Secrets as DATABASE_URL or similar. Copy it to your .env

Related Replit Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help