This guide will help you deploy your web app to the Adaptable Cloud using a Dockerfile.
Using this guide, in just a few clicks, Adaptable deploys all the cloud-based resources you need to run your web app, including:
- Building your app into Serverless Containers
- Fully-managed Serverless Database (MongoDB, PostgreSQL, or MS SQL Server)
- Load Balancing
- HTTPS (SSL/TLS)
»When should I use a Dockerfile?
Adaptable supports many app types natively, without requiring a Dockerfile.
Using a Dockerfile to build your app is helpful:
- For app types that Adaptable does not yet support natively
- If your app has a complex build process
- If you need complete control over the base OS and libraries
- If you already have a working Dockerfile
If you need some help creating a Dockerfile, try the official Docker Samples.
»Step 1: Choose a GitHub repo to deploy
Start by clicking the button below:Deploy Your Own Repo
If you're new to Adaptable, you'll need to sign in with GitHub and authorize Adaptable to access your repo.
Choose the repo you'd like to deploy to Adaptable, then choose a branch.
Once connected, Adaptable will deploy your repo each time you push to this branch.
If you don't see the repo you're looking for, click
Add more GitHub repositories to authorize Adaptable on more of your repos or GitHub organizations.
»Step 2: Choose a Deploy Template
To build your app using a Dockerfile, choose the
Dockerfile App Template.
»Step 3: Choose database type
You can choose to have Adaptable create a new fully-managed database for your app. Adaptable supports MongoDB, PostgreSQL, and Microsoft SQL Server.
If you choose an Adaptable database, Adaptable automatically sets
DATABASE_URL in your app's environment.
If your app does not need a database or if you already have a database hosted elsewhere, choose
»Step 4: Review settings
These settings tell Adaptable where to find your app files and your Dockerfile within your repo.
By default, Adaptable will use the root of your repository as the Docker build context.
If you want to build a subdirectory within your repo, set
Base Directory to the directory you would like to build.
All commands in your Dockerfile are relative to
By default, Adaptable will look in the
Base Directory for a file named
If your Dockerfile is named something else or is in a different directory, set
Dockerfile Name to the complete path plus filename of your Dockerfile within your repo.
When you're satisfied with the settings, click
»Step 5: Choose an app name
Choose a name for your app project on Adaptable.
This name will be used to create a URL for your project like
https://YOURAPPNAME.adaptable.app, so it must be unique among all other app names on Adaptable.
Enter your chosen app name and click
»Step 6: Pre-flight checks
Adaptable will now perform some basic checks on your GitHub repo to ensure it's ready to deploy.
For more information on any of the checks, see Pre-flight checks.
When the checks have passed, click
Deploy App to start deploying your new app.
Once deployment is complete, your app will be running at
You will be redirected to the app status page with a congratulations message if your app deployed successfully.
Otherwise you'll get an error message and some help to resolve the error.
In either case, you will have the option to take a tour to see how Adaptable works!
Now that your app is set up on Adaptable, each time you push to the branch you selected on your GitHub repo, Adaptable will automatically deploy your code changes.
To manage settings for your app and to monitor app logs, click the
App Status button.
Or to see all your Adaptable apps, go to your Dashboard.
If your app didn't build or deploy successfully, click
View Logs next to the failed step to see the related logs.
If you need to make any code changes, you can push to your GitHub repo to update your app and Adaptable will re-deploy it.
Monitor additional deploys by clicking the
App Status button.
If you're still having trouble deploying, contact our support team for help.
»Next Steps: Connect to the database
If you chose to have Adaptable create a new database for your app, Adaptable will automatically set the
DATABASE_URL environment variable.
Ensure your app uses
DATABASE_URL to connect to the Adaptable database.