Articles on: Web Apps

Deploy AdonisJS Apps

Step-by-Step Guide to Deploy AdonisJS Applications on Galaxy Cloud


Introduction


This guide will present a detailed step-by-step process to deploy an AdonisJS application on the Galaxy Cloud. AdonisJS is a TypeScript-first web framework that requires specific build processes and configurations for optimal production performance.


Prerequisites


Before you begin, you will need:

  1. An active account on Galaxy Cloud
  2. GitHub account containing your AdonisJS application
  3. Familiarity with the command line and basic application deployment concepts


Deployment Steps


1. Choose Application Type


Access your Galaxy Cloud dashboard and click "Create New" to start the deployment process.


In the "Choose App Type" section, select AdonisJS as your application platform.


Select AdonisJS


2. Connect Git Provider


Connect your GitHub account by clicking "Continue with GitHub" and authorize Galaxy Cloud to access your repositories. This enables automatic deployments when you push changes to your selected branch.


Select the Git provider


3. Import Repository


Select the Git repository containing your AdonisJS application from the list of available repositories. Make sure your repository includes all necessary AdonisJS configuration files and dependencies.


Import repository

4. Configure Account & Plan


Choose the appropriate plan for your application's performance requirements. This section presents different sizing options for your application's deployment on the Galaxy Cloud platform. The available options are:



  • Nano: 256MB RAM / 0.2 gCPU, estimated cost: $0/mo for 1 container
  • Micro: 512MB RAM / 0.5 gCPU, estimated cost: $6/mo for 1 container
  • Small: 2GB RAM / 1 gCPU, estimated cost: $24/mo for 1 container
  • Medium: 4GB RAM / 2 gCPU, estimated cost: $81/mo for 1 container
  • Large: 8GB RAM / 4 gCPU, estimated cost: $166/mo for 1 container
  • XLarge: 16GB RAM / 4 gCPU, estimated cost: $214/mo for 1 container
  • 2XLarge: 32GB RAM / 8 gCPU, estimated cost: $428/mo for 1 container


Recommended sizing strategy:

  • Nano: Testing apps, simple APIs and microservices with minimal features
  • Small: Standard web applications
  • Medium: Complex applications with databases, caching, and moderate traffic
  • Large+: High-traffic enterprise applications


5. Configure and Deploy


In the "Configure and Deploy" step, you will need to provide specific information about your application. Configure the following settings for your AdonisJS application:



Basic Configuration:

  • Branch: Select the main branch of your Git repository, usually "main"
  • Region: Choose the geographic region where your application will be deployed
  • App Name: Enter a descriptive name for your AdonisJS application
  • Docker Preset: Select AdonisJS 6.x


Essential Environment Variables:


Set the following required environment variables for your AdonisJS application:


Variable

Value

Description

PORT

3333

AdonisJS default port

APP_KEY

[string]

Encryption key (32 characters long)

TZ

UTC

Node.js timezone environment variable

LOG_LEVEL

info

Minimum log severity to record (error, warn, info, debug, trace)

NODE_ENV

production

Application environment (development, production, test)

SESSION_DRIVER

cookie

Session storage mechanism (cookie, file, redis, memory)


After configuring all settings, review your configuration and click "Deploy" to start the deployment process. Monitor the progress and check the logs to ensure your AdonisJS application starts successfully.


Troubleshooting Common Issues


Build Failures:

  • Ensure all dependencies are listed in package.json
  • Verify Node.js version compatibility
  • Check that TypeScript compilation completes without errors


Application Won't Start:

  • Verify APP_KEY is set and is exactly 32 characters
  • Check all required environment variables are configured
  • Ensure database connection details are correct


Database Connection Errors:

  • Verify SSL requirements for managed database services
  • Test connection strings in a development environment first


Conclusion


By following this step-by-step guide, you were able to deploy your AdonisJS application on the Galaxy Cloud. Galaxy Cloud provides a scalable and reliable platform to host your applications, allowing you to focus on development without worrying about the underlying infrastructure.


If you have any questions or need additional assistance, please don't hesitate to contact the Galaxy Cloud support team.

Updated on: 14/08/2025