App Platform Quickstart

Create an App

  1. Go to https://cloud.digitalocean.com/apps and click Create App.
  2. If connecting for the first time, you will see an empty repository list and will need to click the link labeled Configure your GitHub permissions, then refresh this page.
  3. Select the repository that contains your source code, and click Next.
  4. Enter a name for your app, choose the region where you'd like your app to be hosted, and specify the branch in your repository that contains your app's source code. If you'd like to automatically re-deploy your app when pushing to this branch, select Autodeploy code changes. Click Next.
    • App Platform will inspect the code and select an appropriate runtime environment (such as Node, Ruby, etc). If you need to override this, you can see if there is a better options in the drop-down labeled Type as well. If nothing suitable appears there, upload a Dockerfile to your branch and restart the app creation process.
  5. App Platform will display build and run commands that it detected, which you can now customize as needed.
    • If the use of environment variables is required, click Edit and supply them. Click the Encrypt checkbox to ensure a variable's value is obscured in all build, deploy, and application logs.
  6. If your app needs a database, you can add a dev database or an existing managed database from your DigitalOcean account. The connection details for your database will be accessible via environment variables so that they can be conveniently accessed in your code.
  7. Select a plan, and click Launch App.

Scale Your App

  1. Go to https://cloud.digitalocean.com/apps, click on your app, and click on the Components tab.
  2. Click on the component you'd like to scale and click the Edit link next to the Scaling heading.
  3. Scale your application horizontally by increasing the number of containers, or vertically by increasing the container size.
    Tip
    Remember that the ultimate cost of running a component is determined by the container size multiplied by the number of containers.
  4. Click Save.

Add a Database to Your App

  1. Go to https://cloud.digitalocean.com/apps, click on your app, and click on the Components tab.
  2. Click Add Database.
  3. Give your database a name, select an engine, and select a plan.
  4. Click Create Database.
  5. View connection details for your database by clicking on your new database component in the Components tab.

Register a Custom Domain

  1. Go to https://cloud.digitalocean.com/apps, click on your app, and click on the Settings tab.
  2. Then click the Edit link to the right of Domains and Certificates, then click Add Domain.
  3. Enter your domain name at the top of the screen, then follow the onscreen instructions to create a CNAME record with your DNS provider.
  4. Click Add Domain.

Destroy an App

  1. Go to https://cloud.digitalocean.com/apps, and click your app.
  2. Click the Settings tab, and scroll down to the red Destroy button.
  3. Enter the app name to confirm you'd like to delete the app and all its associated components. Then click Destroy.