AWS Builder Center

Your App Works on Your Laptop—But Will It Work in the Cloud?

Your application works locally, but deployment brings new challenges. Learn five practical checks for environment variables, API URLs, database connections, routing, and application logs to help troubleshoot common cloud deployment problems before sharing your project.

Aspiring Software Engineer and Free Lancer
Building an application on your laptop feels great. Your pages load, your API responds, and your database returns the expected results.
Then you deploy it—and suddenly, something breaks.
This is a common challenge for beginners learning cloud deployment. Here are five things to check before blaming the cloud.

1. Check Your Environment Variables

Your application may depend on API keys, database credentials, or configuration values stored on your computer. Configure the required environment variables in your deployment environment, and never upload secrets to a public repository.

2. Verify Your API URLs

An application running locally may call a backend on your own computer. Once deployed, that address won't automatically point to your live backend.
Update your configuration to use the correct deployed API endpoint.

3. Check Your Database Connection

Your local database may not be accessible from your cloud application. Verify the connection settings, network access, credentials, and permissions. Keep database access restricted to the systems that actually need it.

4. Test Routes and Static Files

A page that works when opened directly on your laptop may fail after deployment because of routing rules, missing files, or incorrect paths.
Test navigation, page refreshes, images, and other assets on the deployed version—not just the homepage.

5. Read Logs Before Guessing

When something fails, check your hosting platform's build output, application logs, and error messages. They can help you identify missing variables, failed builds, connection problems, and other configuration issues.

Final Thought

Deployment is not simply uploading files. It means making sure your application, configuration, APIs, and database can work together in a different environment.
Before sharing your next project, test it like a real user would.
If it works only on your laptop, the deployment isn't finished yet!
Any opinions in this article are those of the individual author and may not reflect the opinions of AWS.
Enjoyed reading this content? Let the author know!

Your likes, comments, shares, and saves help creators reach more builders.

Loading recommendations

Loading article