Digital ocean apps
This guide covers the action steps for deploying an AdonisJS application to Digital ocean apps platform .
Deploying an AdonisJS application is no different from deploying a standard Node.js application. You just have to keep a few things in mind:
- You will have to start the server from the
buildfolder and not the project root. Same is true for running migrations any other Node.js apps.
You can build your project for production by running the following ace command. Learn more about the TypeScript build process
node ace build --production# OR use the npm scriptnpm run build
At the time of deploying your application to the DO apps platform, you will be prompted to provide the environment. You can consult the development
.env file for the variables you must define.
- Define the
PORTenvironment variable same as HTTP port you have selected in the settings.
- Make sure to generate the app key by running the
node ace generate:keycommand on your local machine and define it as
- Save the
APP_KEYsecurely. If you lose this key, all the encryption data, cookies, and sessions will become invalid.
- Make sure to change the run command to start the server from the build folder.
You can also add the database as a component to your app and then update the environment variables with the database credentials.
We find Digital ocean database environment variables very generic and recommend re-mapping them as follows:
You must re-map the enviroment variables to be more specific. For example
Once you have added the database, you will have to add a new component of "Job type" and make sure to select "Before every deploy" as its lifecycle.
Digital ocean will make you repeat the same process of a adding a new component, re-selecting repository and re-define the environment variables. However, this time we are adding a job and not a web service.
Also, make sure to update the Run command to
node build/ace make:migration --force.
Digital ocean apps do not have peristant storage and hence you cannot save the user uploaded files on the server filesystem. This leaves you with only one option of saving the uploaded files to an external service like Digital ocean spaces.
We are currently working on a module that allows you to use the local filesystem during development and then switch to an external filesystem like Digital ocean spaces for production. Do all this without changing a single line of code.