No items found.
Docs
Right arrow / chevron
REST API
Right arrow / chevron
Authentication

Authentication

Updated on
May 13, 2023
Published on
February 19, 2024

App Platform retrieves your app’s code from your linked repository (GitHub or GitLab) or container registry (DOCR or Docker Hub), detects the type of language the app is written in, and deploys the app into an appropriate container environment. App Platform hosts the app at a public URL provided by DigitalOcean and can automatically redeploy the app when it detects changes in the repo.


Creating an App Platform app involves three steps:

   1.   Selecting the code base (repository) to pull the code from

   2.  Configuring the detected service, such as environment variables and HTTP routes

   3.  Choosing the app’s details: its name, region, instance type, and size


You can change the configuration and add more services, static sites, and databases after you create the app.

Create Resource From Source Code

To start creating an app using the DigitalOcean Control Panel, click the Create button and then select Apps from the drop-down menu.


On the Choose Resource From Source Code screen, select the code repository service your app resides on. If you have not previously created an app on App Platform, the repository service prompts you to provide DigitalOcean with read permissions to your account.

Select the app’s repo from the Repository drop-down and then select the branch to deploy from in the Branch drop-down menu.


The Source Directory is the directory inside the repo from which to build the app from. The default is the repo’s root directory. For a GitHub monorepo, specify the folder that contains the source. For more information, see Deploy from a Monorepo for more information on how App Platform builds apps from monorepos.


You can choose to opt out of auto-deploying code changes. Uncheck the Autodeploy code changes box to disable App Platform from redeploying the app when it detects changes in the app’s repo.


Once you have selected the app’s repo and branch, click Next. App Platform retrieves your app’s code.


App Platform inspects the code and app resources, and selects an appropriate runtime environment (such as Node, or Ruby). If you need to override this, upload a Dockerfile to your branch and restart the app creation process.

Resources

Resources are deployable runtime software elements in your app. A resource can be a database, a service, a worker, or a static site. On the Resources screen, you can change the plan, configure resource settings or create new resources for your app.

Change plan

Click the Edit Plan button on the Resources screen to scale the app’s resources.

On the Edit Plan screen, you can select one of the following plans as well as scale the app resources vertically by increasing the amount of CPU and memory or horizontally by adding more container instances:

  • Starter - You can only select the Starter plan to host static websites, such as Hugo sites.
  • Basic - Basic plans allow for only one container, vertical scaling, and less outbound transfer and build minutes than the Pro plan. Use the Basic plan for small-scale apps or prototyping your app. Specify the size of the container in the Size section.
  • Pro - The Pro plan includes all of the attributes of the Basic plan and adds more build minutes, horizontal scaling, and high availability. Use the Pro plan to deploy a fully production-ready iteration of your app. Select the number of containers you would like your app to run in the Containers section. Adding additional containers horizontally scales your app to make it more highly available.

As you change the size or the number of containers, the Monthly App Cost section updates to give you an overview of the app’s monthly cost.


For static sites, the Scale screen shows information about the number of apps on your account along with the static site’s name and other resources.


After you configure your scaling settings, click Back to go back to the Resources screen.