App Platform Support

Generated on 5 May 2025

App Platform is a Platform-as-a-Service (PaaS) offering that allows developers to publish code directly to DigitalOcean servers without worrying about the underlying infrastructure.

Why am I receiving 520 status codes from my app?

Your app may have crashed while trying to receive an upload or return a response larger than it has been configured to manage.

Why am I receiving a forbidden error when making changes to my App Platform app?

Your team balance may be past due. Pay your balance to lift restrictions on actions you can take on the platform.

Why does my app not restart when it fails a health check?

If an app’s health check fails, the app currently does not restart. This is because App Platform does not currently support liveness probes. An app only automatically restarts if the app crashes or if its disk or RAM usage exceeds the its limits.

Where can I find the client IP address of a request connecting to my app?

You can find the client IP address of a request connecting to your app in the do-connecting-ip HTTP header.

Why is my app's database connection timing out?

Timeouts can be caused by high CPU utilization, so check your app’s CPU utilization and consider scaling your app.

Why can't I route traffic to my app's dedicated egress IP address?

Dedicated egress IPs route egress (outbound) traffic from an app. To route ingress (inbound) traffic to an app, use one of App Platform’s public ingress IPs.

Why doesn't my app's wildcard subdomain work?

Add the root domain to the list of domains in the app’s settings along with the wildcard subdomain.

Why is my app not resolving .gov domains?

App Platform apps may be slow or unable to resolve .gov domains because the domain administrators have blocked DigitalOcean’s IP addresses. To fix this, you can contact the domain administrator or use a custom DNS resolver.

Why can't I find my app even after paying my past due balance?

If your resources have been destroyed due to a prolonged past due balance, you can contact support to request the app spec for deleted apps to recreate the app with the same configuration.

My PHP app is timing out and throwing 5xx errors

Increase your app’s maximum execution time in its .user.ini file to give it more time to complete requests.

Why is my domain pointing to my old static site app?

Remove the domain from the old app before deleting the old app, or wait 24 hours for the DNS to update.

Why am I receiving a "user does not exist" error when building my Docker app on App Platform?

In your Dockerfile, the USER instruction needs to be after the FROM and WORKDIR instructions.

Why am I receiving an "invalid dockerfile_path" error when building my Docker app on App Platform?

Ensure your Dockerfile’s path is correctly defined using the dockerfile_path parameter in your app spec file.

Why are there multiple 408 errors in App Platform's runtime logs?

Multiple 408 errors are often caused by your app sending health checks with very short timeouts to App Platform. They typically don’t affect the functionality of the app.

Why is my App Platform build or deployment failing with an out of memory error?

App Platform builds have a fixed amount of memory available, so try optimizing your builds to stay within the 8 GB limit. You can increase the amount of memory in App Platform deployments by upgrading to a different plan.

How do I back up my dev database on App Platform?

Dev Databases have no direct backup feature but you can use a cron job to back up your data to another database.

How do I turn off App Platform's email obfuscation feature?

You can wrap email addresses in a code comment that makes the address visible to bots instead of obfuscated.

Why am I receiving “1001 DNS Resolution Error” when accessing my app's subdomain?

You need to explicitly add the subdomain in your app’s settings.

Can I stop, pause, or disable my app on App Platform?

You cannot pause, stop, or disable an app. You can delete the app and re-create it when needed.

Why are my App Platform environment variables not updating?

Component-level variables override app-level variables, so you may have defined environment variables at both levels.

Why does my app fail to build while trying to connect to a DigitalOcean Managed Database?

App Platform does not support connecting to DigitalOcean Managed Databases during the build process if the database has trusted sources enabled.

How do I back up my app on App Platform?

App Platform does not support backups, but you can use DigitalOcean Managed Databases to back up your data.

What region is my app's dev database located in and can I change it?

Dev databases are located in the same region as your app and cannot be migrated to another region.

Why are large files failing to upload to my app on App Platform?

Your upload may be exceeding your app’s allotted file storage space or it could be timing out.

Why does my app have a US-based IP address when I created it in a different region?

You see the CDN load balancer’s IP address. Use dig to see the dynamic IP address of the app.

Why does my app keep restarting on App Platform?

Application crashes, high memory consumption, and high disk usage are usually responsible for apps restarting.

How do I add an A record to my app on App Platform?

Apps do not have static IP addresses so you cannot point an A record at an app.

Why can't I access my environment variables at build time when building from a Dockerfile on App Platform?

Environment variables are only available as build-args for Dockerfile builds in App Platform.

How do I change my app's GitHub repository on App Platform?

You can change an app’s source repository by updating the app’s spec.

Why am I receiving a missing module error when building my Node.js app on App Platform ?

Ensure the missing module is listed in the dependencies section of the package.json file.

Can I inject certificates or other files into my app at build time?

App Platform does not currently support injecting values as files on disk. Use environment variables to create files at run time.

My app failed to build and I received an exit code

Review your app’s build logs to diagnose which process failed during building.

Why are my database bind variables missing from my app?

Database bind variables are only available during an app’s deployment and run times.

My app deployment failed because of a health check

Your app is likely unavailable on the port App Platform uses to perform health checks. Customize the health check or update the ports in your app.

How to Troubleshoot Apps in App Platform

Review some common troubleshooting techniques for App Platform.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.