# Welcome to Clouddley Documentation. Explore Clouddley Docs for in-depth insights into our platform, features, integrations, and expert tips for using them effectively. ### What is Clouddley? Clouddley is a backend infrastructure for your compute resources, including virtual machines, servers, and bare metal. It provides zero-downtime deployment capabilities, ensuring your application remains accessible during updates and maintenance. Using the **BYOC (Bring Your Own Cloud)** model, Clouddley enables you to deploy across multiple cloud providers, including AWS EC2 Instances, DigitalOcean Droplets, GCP Compute Engine, and many more. This makes it an excellent solution for smooth application deployments, database management, broker set-up and many more. ### Our Products Here’s a brief overview of what we offer, along with detailed documentation to guide you.


Apps Deploy Apps on your virtual machines, servers & bare metal. You can deploy Dockerfiles, view real-time application logs, and add a custom domain.	/pages/zQJQP8UpFgzUjFOliZHy	/files/3NRxViStK0o8729WVhho
Databases Deploy and manage databases like Redis, MySQL, MariaDB, and PostgreSQL on your virtual machines.	/pages/OYAyMRgFwZk1ywVtc1lS	/files/5F1ErnEIb4L4zqiYHKJ0
Brokers Coming Soon… Deploy services like NATS and RabbitMQ on virtual machines.		/files/NjEhof03JopMd0eAIuX9
AI Coming Soon… Deploy open-source LLMs on your VM effortlessly using an OpenAI-compatible API.		/files/6S6CN4n3sfMoPmFvGlol

# Apps An overview of running applications on Clouddley, its key features to help you get started.

Image of Apps dashboard. — Apps Dashboard

### Overview Apps represent your application workloads deployed on Clouddley running on virtual machines, servers, and bare metal with zero downtime. Using cloud-native tooling, it automatically detects your runtime, whether it's **Python, Go, Ruby, or any other language**, and handles the deployment for you. Just connect your repo with or without a Dockerfile, and Clouddley takes care of the rest. This makes it a great solution for web applications, APIs, microservices, and high availability across different cloud environments. ### Key Features Here is a breakdown of key features Apps supports; * **GitHub and Bitbucket Integration** Connect your GitHub or Bitbucket repositories to enable automated deployments directly from your codebase, ensuring smooth version control and continuous integration workflows. * **Multiple Operating Systems** Deploy and manage applications across various operating systems, including Ubuntu, Debian, CentOS and many more, to ensure extensive compatibility in both development and production environments. * **Multi-framework and Multi-language support** Deploy applications created with a variety of frameworks and programming languages, providing you with flexibility across various technology stacks. * **Dockerfile integration** Effortlessly deploy containerized applications with Dockerfiles to maintain consistent, portable environments across diverse systems. * **Deployment and Application Logs** Gain access to detailed logs for deployments and applications, enabling real-time monitoring and efficient troubleshooting. * **Scalability Options** Easily scale applications to meet demand to maintain optimal performance under varying loads. * **Pause and Resume Deployments** Pause and resume deployments temporarily as needed, offering flexibility for maintenance, debugging, or scheduled downtimes without interrupting workflows. * **Email Notification** Receive email alerts for important deployment events, keeping you updated in real-time on the status and health of your applications. * **Instant, Automatic and Manual Rollbacks** Quickly revert to previous versions using the Apps rollback feature, which allows for automatic rollbacks on failure, instant, and manual rollbacks for added control. * **Custom Domain Configuration** Configure custom domains for your applications to improve branding and accessibility for users. {% content-ref url="/pages/UOMnjrpko0b2UvKmUt0K" %} [How-to Guides](/apps/how-to-guides) {% endcontent-ref %} {% content-ref url="/pages/VGINbGG5NDARoYw8jk4G" %} [Extras](/apps/extras) {% endcontent-ref %} # How-to Guides Learn how to deploy different apps to Clouddley.


Deploy a Ruby on Rails App on Clouddley	/files/SJceS3IUs0RbKEbDaJSg	/pages/d4NmeESuRxUyHxu8clFD
Deploy a Next.js App on Clouddley	/files/HEcCmQ2wLjUHOlJgAJdy	/pages/s80jSPl4u7CYyAygiptR
Deploy a Go Application on Clouddley	/files/TFSuYjBLr6fTGoOFiAjT	/pages/67hkZjbMQvNC3cWTyPcf
Deploy a NestJS App on Clouddley	/files/Erg2tDyhGgnNyvq615hN	/pages/8lxPNe47Q4AWpsgO96Nz
Deploy a FastAPI App on Clouddley	/files/LfJa3UyFv3HKULoFkSAh	/pages/99DssvkCXnNMJkDMEdLd
Deploy a .NET Core App on Clouddley	/files/vcw8uQouyhi9FWrB1de3	/pages/SiyBt51GuXI0SGMfsi5D
Deploy a Flask App on Clouddley	/files/Ag2pc6JbV8UAbsN03RDy	/pages/u70ElRJYNhmq41SzHA5K
Deploy an Express.js Application on Clouddley	/files/BRLHrmm6zcZHmNKKZWlD

# Deploy a Ruby on Rails App on Clouddley Learn how to deploy a Ruby on Rails app on Clouddley. In this guide, you'll learn how to deploy a[ Ruby on Rails](https://rubyonrails.org/) Application on Clouddley, a backend infrastructure for your compute resources that is an advanced runtime auto-detection platform for zero-downtime deployments across different server types. Let's begin! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) account. * A [Clouddley](https://clouddley.com/) account. * A [Ruby on Rails](https://rubyonrails.org/) application. * A virtual machine on a Cloud platform or bare metal server. ### Deploy your Ruby on Rails Application #### **Create a Dockerfile** Before deploying your Ruby app on Clouddley, create a Dockerfile `triggr.dockerfile` which defines how the Ruby app should be containerized. {% hint style="info" %} **Best Practice:** When creating a Dockerfile, use a lightweight base image to reduce image size. Always specify exact versions for dependencies to ensure consistency. {% endhint %} {% code title="triggr.dockerfile" %} ```docker FROM ruby:3.4.4-alpine # Install only the essentials for your gems RUN apk add --no-cache \ build-base \ yaml-dev \ nodejs \ yarn \ tzdata \ git # Set working directory WORKDIR /app # Copy Gemfile and Gemfile.lock first (for caching) COPY Gemfile Gemfile.lock ./ # Install gems RUN bundle install # Copy the rest of the application COPY . . EXPOSE 3000 CMD ["rails", "server", "-b", "0.0.0.0"] ``` {% endcode %} **Building and Running the Container Locally** Before deploying to **Apps**, verify that the container works locally. 1. **Build the Docker image**: ``` docker build -t ruby-app -f triggr.dockerfile . ``` 2. **Run the container**: ``` docker run -d -p 3000:3000 --name ruby-container ruby-app ``` 3. **Verify the app is running** by visiting `http://localhost:3000` #### **Accessing Apps on Clouddley** * Open your browser and log in to your Clouddley account * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy App**

Image of Triggr Apps dashboard. — Accessing Apps on Clouddley

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

Configuring Git hosting service during app deployment on Apps. — Choose your Git hosting service

#### **Step 2: Configure Git** * To connect your GitHub user or organization account, click the **Select username/organization** dropdown and **Add GitHub account.** * Select your **repository** and the **branch** from the dropdown list or quickly search. * Click on **Next**

Configuring the Git repository during app deployment on Apps. — Setup the Ruby on Rails application repository on Clouddley

#### **Step 3: Configure your Virtual Machine** In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the following details to configure your VM: * Hostname or IP address * Username * SSH port After adding the details, use the **Clouddley CLI** (recommended) or connect via **SSH** to verify the connection. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Run the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify**. This verifies the connection. * Click on **Next**

Configuring the virtual machine during app deployment on Clouddley — Configuration of virtual machine on Clouddley

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

Configuring App settings (name and port) during app deployment on Clouddley — Configure the App name and port

{% hint style="info" %} The firewall of the virtual machine should allow access to the application port. {% endhint %} #### **Step 5: Configure Environment Variables** * To add environment variables, click on :heavy\_plus\_sign: **Add Variable** * Choose an ENV mode: either a **single variable** or **import variables**. Learn more [here](/apps/extras/environment-variables). {% tabs %} {% tab title="Single Variable" %}

Image showing the single variable ENV mode on Clouddley — Single variable ENV mode

{% endtab %} {% tab title="Import Variables" %}

Image showing the Import Variables ENV mode on Clouddley. — Import variables ENV mode

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **Next**

Image showing environment variables added during app deployment on Clouddley. — Adding environment variables

#### **Step 6: Set up Notifications (optional)** * To configure the **notification settings** of the application, click on :heavy\_plus\_sign: **Add Alert** * Select the **Alert type.** For this tutorial, we will set up Email alerts. * Toggle on the buttons of the deployment event (failed, timed out, or success) you want to be notified of. * Enter the **Email address** where you want to receive alerts. (You can add multiple email addresses) * Click on **Save** * Click on **Deploy**

A gif showing how to set up notifications on Clouddley. — Notifications set up and creation of Ruby on Rails application on Clouddley

#### **Step 7: Test and Verify the app** * Click on **Go to Dashboard. Y**our app will be visible on the apps dashboard. * After the app deployment is complete, the app status changes from `Deploying` to `Online`

An image of the overview of a successfully deployed Ruby on Rails application on Clouddley. — Ruby on Rails application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the Ruby on Rails application running on Clouddley on the web. — Ruby on Rails application running from Clouddley on a cloud virtual machine

You have deployed a Ruby on Rails application successfully on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Additionally, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment variables**. ### **Conclusion** You've successfully deployed a Ruby on Rails application on Clouddley! To access the source code of this application, check [here](https://github.com/clouddley/examples/tree/main/ruby-on-rails). Furthermore, to explore how different frameworks can be deployed on Clouddley, check out our [how-to guides](/apps/how-to-guides). # Deploy a Flask Application on Clouddley Learn how to deploy a Flask app on Clouddley. Clouddley is a powerful backend infrastructure platform that enables you to deploy a Flask application seamlessly, with zero downtime on your server. In this guide, we'll walk you through the [Flask](https://flask.palletsprojects.com/en/2.3.x/) application deployment process, highlighting why Clouddley is your ideal choice for efficient deployments with ease. Let's get started! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://clouddley.com/) account. * A [Flask](https://flask.palletsprojects.com/en/2.3.x/) application. * A virtual machine on a Cloud platform or bare metal server. ### Deploy your Flask Application **Optimize your codebase for deployment** To deploy a Flask application on Clouddley, create a `Procfile` in the root directory of your project. This specifies the command used to run the application. {% code title="Procfile" %} ``` web: python app.py ``` {% endcode %} #### **Accessing Apps** Now, let's move on to deploying the Flask application: * Open your web browser and sign in to your Clouddley account * Proceed to [Apps](https://app.clouddley.com/apps) and click on **Deploy app**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

Configuring the Git repository during app deployment on Triggr Apps. — Setup the Flask application repository on Clouddley

Configuring the virtual machine during app deployment — Configuration of virtual machine on Clouddley

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

Configuring App settings (name and port) during app deployment. — Configure the App name and port

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **Next**

A gif showing how to set up notifications during app deployment on Clouddley.. — Notifications set up and creation of Flask application on Clouddley

An image of the overview of a successfully deployed Flask application on Triggr Apps. — Flask application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the Flask application running on Clouddley on the web. — Flask application running from Clouddley on a cloud virtual machine

You have successfully deployed a Flask application on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Furthermore, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment** **variables**. ### **Conclusion** Congratulations :tada: on successfully deploying a Flask application on Clouddley. You can access the source code for this application [here](https://github.com/clouddley/examples/tree/main/python/flask). Additionally, you can explore how different frameworks can be deployed on Clouddley in our [how-to guides.](/apps/how-to-guides) # Deploy a .NET Core Application on Clouddley Learn how to deploy a .NET Core app on Clouddley. In this article, our focus will be on deploying a [.NET Core](https://learn.microsoft.com/en-us/aspnet/core/introduction-to-aspnet-core?view=aspnetcore-7.0) application on Clouddley. However, before going into that, it's important to understand Clouddley. Clouddley is a backend infrastructure platform for your compute resources that auto-detects your runtime and deploys your application to your server (virtual machines and bare metal). So, let's get started! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://clouddley.com/) account. * A [.NET Core](https://learn.microsoft.com/en-us/aspnet/core/introduction-to-aspnet-core?view=aspnetcore-7.0) application. * A virtual machine on a Cloud platform or a bare metal server. ### Deploying your .NET Core Application **Create a Dockerfile** In the application root directory, create a Dockerfile `triggr.dockerfile` that defines how the app should be containerized. {% hint style="info" %} **Best Practice:** When creating a Dockerfile, use a lightweight base image to reduce image size. Always specify exact versions for dependencies to ensure consistency. {% endhint %} {% code title="triggr.dockerfile" %} ```docker # Build stage FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build WORKDIR /src # Copy csproj and restore dependencies COPY *.csproj ./ RUN dotnet restore # Copy everything else and build COPY . ./ RUN dotnet publish -c Release -o /app/publish /p:UseAppHost=false # Runtime stage FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS final WORKDIR /app COPY --from=build /app/publish . # Set the port to match local dev EXPOSE 5013 ENTRYPOINT ["dotnet", "newApp.dll"] ``` {% endcode %} **Building and Running the Container Locally** Before deploying to **Apps**, verify that the container works locally. 1. **Build the Docker image**: ``` docker build -t new-app -f triggr.dockerfile . ``` 2. **Run the container**: ``` docker run -d -p 5013:5013 --name new-app-container new-app ``` 3. **Verify the app is running** by visiting `http://localhost:5013`. **Accessing Apps** * Launch your web browser and log in to your Clouddley account. * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy App**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

Configuring Git hosting service during app deployment on Clouddley. — Choose your Git hosting service

Configuring the Git repository during app deployment on Clouddley. — Setup the .NET Core application repository on Clouddley

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% hint style="info" %} Ensure the virtual machine's firewall permits access to the application port. {% endhint %} #### **Step 5: Configure Environment Variables** * To add environment variables, click on :heavy\_plus\_sign: **Add Variable** * Choose an ENV mode: either a **single variable** or **import variables**. Learn more [here](/apps/extras/environment-variables). {% tabs %} {% tab title="Single Variable" %}

Image showing the Single Variables ENV mode on Clouddley. — Single variable ENV mode

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} {% hint style="info" %} To deploy your .NET Core application on Clouddley, you need to set the URL for the application as an environment variable, which can either be `DOTNET_URLS` or `ASPNETCORE_URLS`. Since this is an ASP.NET Core application, we will set; {% code fullWidth="false" %} ```bash key: ASPNETCORE_URLS value: http://0.0.0.0:5013 ``` {% endcode %} {% endhint %} * Add the key-value pairs and click on **Save** * Click on **Next**

#### **Step 7: Test and Verify the app** * Click on **Go to Dashboard.** Your app will be visible on the apps dashboard. * After the app deployment is complete, the app status changes from `Deploying` to `Online`

An image of the overview of a successfully deployed Dotnet application on Clouddley. — .NET Core application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the Dotnet application running from Clouddley on the web. — .NET Core application running from Clouddley on a cloud virtual machine

You have deployed a .NET Core application successfully on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Additionally, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment variables**. ### Conclusion Congratulations :tada: on successfully deploying a .NET Core application on Clouddley!. Feel free to explore the source code for this application [here](https://github.com/clouddley/examples/tree/main/dotnet-core). Furthermore, you can explore our [how-to guides ](/apps/how-to-guides)to discover how various frameworks can be deployed on Clouddley. # Deploy a FastAPI App on Clouddley Learn how to deploy a FastAPI app on Clouddley. In this article, we'll learn how to deploy a [FastAPI ](https://fastapi.tiangolo.com/)application on Clouddley. Before that, What is Clouddley? Clouddley is a backend infrastructure platform for your compute resources that auto-detects your runtime and deploys your application to your server (virtual machines and bare metal). Let’s begin! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://clouddley.com/) account. * A [FastAPI](https://fastapi.tiangolo.com/) application. * A virtual machine on a Cloud platform or a bare metal server. ### Deploy your FastAPI Application **Optimize your codebase for deployment** To deploy a FastAPI application on Clouddley, you need to create a `Procfile` in the root directory of your project. This specifies the command used to run the application. {% code title="Procfile" %} ``` web: python main.py ``` {% endcode %} #### **Accessing Apps** * Open your web browser, log in to your Clouddley account * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy App**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **NEXT**

An image of the overview of a successfully deployed FastAPI application on Clouddley. — FastAPI application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the FastAPI application running on Clouddley on the web. — FastAPI application running from Clouddley on a cloud virtual machine

You have successfully deployed a FastAPI application on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Furthermore, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment** **variables**. ### Conclusion Congratulations:tada: on successfully deploying a FastAPI application on Clouddley. You can find the application source code [here](https://github.com/clouddley/examples/tree/main/python/fastapi). You can also check out how different frameworks can be deployed on Clouddley in our [how-to guides](/apps/how-to-guides). # Deploy a NestJS App on Clouddley Learn how to deploy a NestJS app on Clouddley. In this article, we'll learn how to deploy a [NestJs](https://nestjs.com/) application on Clouddley. Before that, let’s talk about what Clouddley is. Clouddley is a backend infrastructure platform for your compute resources that auto-detects your runtime and deploys your application to your server, virtual machines, and bare metal. Let's begin! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://clouddley.com/) account. * A [Nestjs](https://nestjs.com/) application. * A virtual machine on a Cloud platform or a bare metal server. ### Deploy your NestJS Application **Optimize your codebase for deployment** * For your application to deploy successfully on Clouddley, you need to create a `Procfile` in the root folder of your project with the following contents: {% hint style="info" %} This differs depending on which package manager you used for your app creation. {% endhint %} {% tabs %} {% tab title="NPM" %} web: npm run start:prod {% endtab %} {% tab title="YARN" %} web: yarn start:prod {% endtab %} {% tab title="PNPM" %} web: pnpm run start:prod {% endtab %} {% endtabs %} #### **Accessing Apps** * Open your web browser, log in to your Clouddley account * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy App**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

#### **Step 3: Configure your Virtual Machine** In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the following details to configure your VM: * Hostname or IP address * Username * SSH port After adding the details, use the **Clouddley CLI** (recommended) or connect via **SSH** to verify the connection. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To install Triggr, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Run the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify**. This verifies the connection * Click on **Next**

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} * Add the key-value pairs, and click on **Save.** * Click on **Next**

An image of the overview of a successfully deployed NestJS application on Clouddley. — NestJS application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the NestJS application running from Clouddley on the web. — NestJS application running from Clouddley on a cloud virtual machine

You have successfully deployed a NestJS application on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Furthermore, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment** **variables**. ### Conclusion Congratulations:tada: on successfully deploying a NestJS application on Clouddley. You can find the application source code [here](https://github.com/clouddley/examples/tree/main/nodejs/nestjs). You can also check out how different frameworks can be deployed on Clouddley in our [how-to guides](/apps/how-to-guides). # Deploy a Go Application on Clouddley Learn how to deploy a Go app on Clouddley. This article will walk you through the process of deploying a [Go](https://go.dev/doc/) application to a server using Clouddley, a backend infrastructure platform for your compute resources that auto-detects your runtime and deploys your application to your server (virtual machines and bare metal). Let’s dive in! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://app.clouddley.com/auth/signup) account. * A [Go](https://go.dev/doc/) application. * A virtual machine on a Cloud platform or bare metal server. ### Deploy your Go Application **Optimize your codebase for deployment** Based on Clouddley's design, deploying a Go application differs for API and full-stack development. We will be showing these two use cases below. {% tabs %} {% tab title="Go Full-Stack" %} To deploy a full-stack Go application on Clouddley, you need to create a [Toml](https://docs.fileformat.com/programming/toml/#what-is-a-toml-file) file `project.toml` in the root directory of your project. {% code title="project.toml" %} ```toml [[build.env]] name="BP_KEEP_FILES" value="static/*" ``` {% endcode %} The `value` should specify the folder containing all the files without the `.go` extension for Clouddley to include them during the build process. For this application, the files can be found in a folder named `static` You can check out the code for this application [here](https://github.com/clouddley/examples/tree/main/go/go-fullstack). {% endtab %} {% tab title="Go API" %} For this use case, we deployed a simple Go API You can check out the code for this application[ here](https://github.com/clouddley/examples/tree/main/go/go-api). {% endtab %} {% endtabs %} #### **Accessing Apps** * Open your web browser, log in to your Clouddley account * Navigate to [Apps ](https://app.clouddley.com/apps)and click on **Deploy** **App**

Image of Apps dashboard on Clouddley. — Accessing Apps

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

#### **Step 3: Configure your Virtual Machine** In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the following details to configure your VM: * Hostname or IP address * Username * SSH port After adding the details, use the **Clouddley CLI** (recommended) or connect via **SSH** to verify the connection. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Triggr to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify**. This verifies the connection. * Click on **Next**

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% endtab %} {% tab title="Import Variables " %}

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **Next**

#### **Step 7: Test and Verify the app** * Click on **Go to Dashboard.** Your app appears on the apps dashboard. * After the app deployment is complete, the app status changes from `Deploying` to `Online`

An image of the overview of a successfully deployed Go application on Clouddley. — Go application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the Go application running from Clouddley on the web. — Go application running from Clouddley on a cloud virtual machine

You have successfully deployed a Go application on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Additionally, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment** **variables**. ### Conclusion Congratulations:tada: on successfully deploying a Go application on Clouddley. Check out how different frameworks can be deployed to Clouddley in our [how-to guides](/apps/how-to-guides). # Deploy a Next.js App on Clouddley Learn how to deploy a Next.js app on Clouddley. Clouddley is a backend infrastructure platform for your compute resources that auto-detects your runtime and deploys your application to your server (virtual machines and bare metal). In this guide, you’ll see Clouddley in action by deploying a [Next.js](https://nextjs.org/learn/foundations/about-nextjs/what-is-nextjs) web application (built with [Next.js boilerplate](https://vercel.com/templates/next.js/nextjs-boilerplate)) to a virtual machine. ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://app.clouddley.com/auth/signup) account. * A [N](https://nextjs.org/learn/foundations/about-nextjs)[ext.js](https://nextjs.org/learn/foundations/about-nextjs) application. * A virtual machine on a Cloud platform or a bare metal server. ### Deploy your Next.js Application #### **Accessing Apps** * Open your web browser, log in to your Clouddley account * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy** **App**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

#### **Step 3: Configure your Virtual Machine** In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the following details to configure your VM: * Hostname or IP address * Username * SSH port After adding the details, use the **Clouddley CLI** (recommended) or connect via **SSH** to verify the connection. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Triggr to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify**. This verifies the connection. * Click on **Next**

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **Next**

An image of the overview of a successfully deployed Next.js application on Clouddley. — Next.js application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the Next.js application running from Clouddley on the web. — Next.js application running from Clouddley on a cloud virtual machine

You have successfully deployed a Next.js application on Clouddley. You can manage it directly from the app dashboard by clicking the three dots (**...**) at the top-right corner to access **Edit**, **Instant Rollback**, **Scale**, **Pause**, and **Delete** options. Additionally, you can switch to different tabs on the application dashboard to perform the following actions: view your **deployment** history, view or download **logs**, add a **custom domain**, and view the **environment** **variables**. ### Conclusion Congratulations:tada: on successfully deploying a Next.js application on Clouddley. You can check out the source code for this application [here](https://github.com/clouddley/examples/tree/main/nodejs/nextjs). You can also check out how different frameworks can be deployed on Clouddley in our [how-to guides](/apps/how-to-guides). # Deploy an Express.js Application on Clouddley Learn how to deploy an Express.js App on Clouddley. Clouddley makes it easy to deploy your [Express.js](https://expressjs.com/) application, ensuring zero downtime on your server. Express.js is a lightweight and flexible Node.js framework designed for building fast and scalable web applications. In this guide, we will walk you through the deployment process, showing you why Clouddley is the perfect choice for your deployments. So, let's begin! ### Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://clouddley.com/) account. * An [Express.js](https://expressjs.com/) application. * A virtual machine on a Cloud platform or a bare metal server. ### Deploy your Express.js Application #### **Accessing Apps** * Open your web browser, log in to your Clouddley account * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy** **App**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

#### **Step 3: Configure your Virtual Machine** In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the following details to configure your VM: * Hostname or IP address * Username * SSH port After adding the details, use the **Clouddley CLI** (recommended) or connect via **SSH** to verify the connection. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Triggr to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify**. This verifies the connection. * Click on **Next**

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **Next**

An image of the overview of a successfully deployed Express.js application on Clouddley — Express.js application dashboard overview

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

An image of the Express.js application running from Clouddley on the web. — Express.js application running from Clouddley on a cloud virtual machine

The Express.js application has been successfully deployed on Clouddley. You can manage it from the application dashboard by selecting the three-dot menu (**…**) in the top-right corner, where you will find options to **Edit, Instant Rollback, Scale, Pause, or Delete** the deployment. Additionally, you can navigate through the dashboard tabs to: * View deployment history * Access and download logs * Add a custom domain * View and manage environment variables ### **Conclusion** You've successfully deployed an Express.js application on Clouddley! Feel free to explore the source code for this application [here](https://github.com/clouddley/examples/tree/main/nodejs/express). Additionally, check out our [how-to guides](/apps/how-to-guides) to learn more about deploying different frameworks on Clouddley. # Extras Find out more features and details about Apps. {% content-ref url="/pages/QqW27c2uJpum2DiUetzp" %} [Notifications](/apps/extras/notifications) {% endcontent-ref %} {% content-ref url="/pages/n5PczdHw3kD1hcEuowvv" %} [Environment Variables](/apps/extras/environment-variables) {% endcontent-ref %} {% content-ref url="/pages/EGCKkfvgzcxfxdq3BSG1" %} [How to Rollback an Application](/apps/extras/how-to-rollback-an-application) {% endcontent-ref %} {% content-ref url="/pages/M5REyH4JFenlvLg24cRm" %} [Custom Domain](/apps/extras/custom-domain) {% endcontent-ref %} {% content-ref url="/pages/yhKaVjVzvwqBBgQUCF3y" %} [How to Pause and Resume Applications](/apps/extras/how-to-pause-and-resume-applications) {% endcontent-ref %} {% content-ref url="/pages/7vQW9iXvDU9WvMzHFSj9" %} [Scale applications on Clouddley](/apps/extras/scale-applications-on-clouddley) {% endcontent-ref %} {% content-ref url="/pages/Ddwbm26GngE1y7CeObda" %} [Deploy an Application with a Dockerfile on Clouddley](/apps/extras/deploy-an-application-with-a-dockerfile-on-clouddley) {% endcontent-ref %} # Notifications Notifications for Apps on Clouddley Setting notifications keeps you informed on your app's deployment status. On Apps, you can set up notifications for your applications. To set up notifications while creating your app, follow these instructions; * In the Notifications section, click on :heavy\_plus\_sign: **Add Alert** * Select the **alert type** from the dropdown menu {% hint style="info" %} Apps support only the **Email alert** type for now. {% endhint %} * Once you select the alert type, enable the **event** you want to be notified of, which could be either; * :white\_check\_mark: When the deployment succeeds * :pause\_button: When the app deployment timed out * :x: When the app deployment fails * Type in the email address(es) you want to receive alerts on and click on **Save.** * Go ahead and deploy your application.

Image showing the various alert types for app deployment on Clouddley — Notification section Apps

# Environment Variables Environment variables for Apps on Clouddley. Environment variables are key-value pairs used to configure applications dynamically without modifying code. For Apps on Clouddley, there are two modes for managing environment variables: * **Single Variable:** Manually add individual environment variables. * **Import Variables:** Bulk import multiple environment variables for easier management. {% tabs %} {% tab title="Single Variable" %}

Image showing the single variable ENV mode for Apps on Clouddley. — Single Variable ENV mode

{% endtab %} {% tab title="Import Variables" %}

Image showing the Import Variables ENV mode for Apps on Clouddley. — Import variables ENV mode

{% endtab %} {% endtabs %} You can edit environment variables at any time after creating your application, ensuring flexibility in configuration updates. # Custom Domain Custom Domain for Apps on Clouddley. Setting up a custom domain enhances accessibility for users and improves your brand’s identity. {% hint style="info" %} Clouddley uses [Google Cloud Armor](https://cloud.google.com/armor/docs/cloud-armor-overview#:~:text=Google%20Cloud%20Armor%20helps%20you,and%20SQL%20injection%20\(SQLi\).) in the background to protect your custom domain from distributed denial-of-service (DDoS) and other web-based attacks. It filters and routes all traffic through Google’s Load Balancer, ensuring that only legitimate requests reach your application. {% endhint %} To set up your custom domain on Clouddley, follow these instructions: 1. Navigate to **Apps** and select your **app.** 2. On the App dashboard, select **Custom Domain** and click on **+ Add Custom Domain.**

Image showing the custom domain section on Clouddley. — Custom domain overview page

3. Enter the **name** of your domain and click on **Add Domain.**

Adding the domain name to an app in custom domain set up on Clouddley. — Adding a domain name to setup custom domain

4. Follow the instructions provided to configure a **DNS Record.**

Configuring DNS record during custom domain set up on Clouddley. — Configuring a Record for the domain

5. After DNS propagation, the custom domain is **verified**. To make it a default domain, turn on **Set as default domain**.

Successful domain verification on Clouddley

Your application is now connected to a custom domain.

Custom domain set up successfully on Clouddley. — Custom domain set up successfully

You can add multiple custom domains to your application and set one as the default. # How to Rollback an Application Learn how to rollback applications on Clouddley. Rolling back an application allows you to revert to a previous version if issues arise, ensuring stability with no downtime. On Clouddley, there are three types of rollback: **instant, manual, and automatic**. Rollback is only possible if the app has at least two successful previous deployments. This article outlines the steps to perform each rollback method. **Rolling Back an Application on Clouddley** To roll back your application to a previous version, follow these steps: {% tabs %} {% tab title="Instant Rollback" %} **Instant rollback** lets you quickly revert to the last successful deployment with just a few clicks. * Navigate to **Apps** and select the application to open its **Overview** page. * Click the **More Options** menu (**⋮**) in the top-right corner. * From the menu, select **Rollback**.

User performs instant rollback of an application on Clouddley. — Instant rollback of an application on Clouddley

{% endtab %} {% tab title="Manual Rollback" %} **Manual rollback** allows you to revert to a specific previous deployment by manually selecting and restarting the build. * Go to **Apps** and open your application's **Overview** page. * Navigate to the **Deployments** section and select the version you want to rollback to. * Click the **(⋮) Actions** menu next to the deployment and select **Restart Build**.

User performs manual rollback of an application on Clouddley. — Manual rollback of an application on Clouddley

{% endtab %} {% tab title="Automatic Rollback" %} **Automatic rollback** occurs when a deployment fails due to a bug. Clouddley detects the failure and automatically reverts to the last successful deployment, ensuring stability without manual intervention. {% endtab %} {% endtabs %} Rolling back an application is a quick and effective way to restore a stable version when needed. By following these steps, you can easily revert changes and maintain the reliability of your application. For further assistance, contact support. # How to Pause and Resume Applications Learn how to stop and resume applications on Clouddley. Managing application availability is essential for optimizing resources on Clouddley. The ability to **pause and resume applications** allows you to temporarily stop an application when it's not in use and restart it when needed. To pause or resume your application on Apps, follow these steps: **Step 1:** Navigate to the application dashboard and select the application to open its **Overview** page. **Step 2:** Click the **More Options** menu (**⋮**) in the top-right corner. **Step 3:** From the menu, select **Pause** to stop the application or **Resume** to restart it. A confirmation message will appear once the action is complete: **`Pause completed!`** for paused applications and **`Resume completed!`** for resumed applications.

User pauses and resumes an application on Clouddley. — Pausing and resuming an application on Clouddley

#### **Conclusion** Pausing and resuming applications is a simple yet powerful way to manage your resources efficiently. By following these steps, you can easily control application availability as needed. If you encounter any issues, contact support for assistance. # Scale applications on Clouddley Learn how to scale applications on Clouddley. Scaling an application on Clouddley is simple and efficient. Users can adjust the application's resources by using the **scaling slider** to increase or decrease capacity. Clouddley support a scaling capacity ranging from a minimum of 1 to a maximum of 50.\ To scale your application on Clouddley, follow these steps: **Step 1:** Navigate to the application dashboard and select the application to open its **Overview** page. **Step 2:** Click the **More Options** menu (**⋮**) in the top-right corner. **Step 3:** From the menu, select **Scale** to scale the application. **Step 4:** Adjust the slider value to scale as needed and then click on **Update**.

An image of Apps scaling slider on Clouddley. — Apps scaling slider

A confirmation message **`Scaling completed!`** will appear once scaling is complete.

User scales an application on Clouddley — Scaling an application on Clouddley

This allows applications to scale up during high-demand periods for optimal performance and scale down during low-traffic times to optimise resource usage. With this flexibility, Clouddley ensures efficient application management under varying loads. # Deploy an Application with a Dockerfile on Clouddley Learn how to deploy an application using a Dockerfile on Clouddley. Deploying applications with a **Dockerfile** on **Clouddley** allows you to containerize and manage your application efficiently. This guide provides step-by-step instructions on deploying an Express.js application using a Dockerfile, ensuring a seamless and reliable deployment process. ## Prerequisites * A [GitHub](https://github.com/) or [Bitbucket](https://bitbucket.org/product) Account. * A [Clouddley](https://clouddley.com/) account. * Basic understanding of [Docker](https://www.docker.com/). * An [Express.js](https://expressjs.com/) application. * A virtual machine on a Cloud platform or bare metal server. ## Creating a Dockerfile In the application root directory, create a Dockerfile `triggr.dockerfile` that defines how the app should be containerized. {% hint style="info" %} **Best Practice:** When creating a Dockerfile, use a lightweight base image (e.g., `node:alpine` for Node.js apps) to reduce image size. Always specify exact versions for dependencies to ensure consistency. {% endhint %} {% code title="triggr.dockerfile" %} ```docker # Use an official Node.js runtime as a parent image FROM node:18-alpine # Set the working directory in the container WORKDIR /app # Copy package.json and package-lock.json first for dependency installation COPY package*.json ./ # Install dependencies RUN npm install --omit=dev # Use --omit=dev for production builds # Copy the rest of the application code COPY . . # Expose the application port (ensure it matches the port your app listens on) EXPOSE 3011 # Define the command to run the application CMD ["node", "./bin/www"] ``` {% endcode %} ### Building and Running the Container Locally Before deploying to **Apps**, verify that the container works locally. 1. **Build the Docker image**: ``` docker build -t my-express-app -f triggr.dockerfile . ``` 2. **Run the container**: ``` docker run -d -p 3011:3011 --name express-container my-express-app ``` 3. **Verify the app is running** by visiting `http://localhost:3011`. ### Deploying the Application #### **Accessing Apps** * Open your web browser, log in to your Clouddley account * Navigate to [Apps](https://app.clouddley.com/apps) and click on **Deploy** **App.**

#### **Step 1: Configure Service** * Choose your Git hosting service; either **GitHub** or **Bitbucket**. For this tutorial, we will be using GitHub. * Click on **Continue with GitHub**

#### **Step 3: Configure your Virtual Machine** In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the following details to configure your VM: * Hostname or IP address * Username * SSH port After adding the details, use the **Clouddley CLI** (recommended) or connect via **SSH** to verify the connection. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify**. This verifies the connection. * Click on **Next**

#### **Step 4: Configure app settings** * Insert the **name** of the application and its **port.** * Click on **Next**

{% hint style="info" %} The firewall of the virtual machine should allow access to the application port. {% endhint %} #### **Step 5: Configure Environment Variables** * To add environment variables, click on :heavy\_plus\_sign: **Add Variable** * Choose an **ENV mode**, which can be either single or **import variables.** Learn more [here](/apps/extras/environment-variables). {% tabs %} {% tab title="Single Variable" %}

{% endtab %} {% tab title="Import Variables" %}

{% endtab %} {% endtabs %} * Add the key-value pairs and click on **Save** * Click on **Next**

* Click on :globe\_with\_meridians: **Website** at the top right corner of the page, which opens the URL of the deployed application in your browser. * You can test the application functionalities.

The Express.js application has been successfully deployed on Clouddley with a Dockerfile. You can manage it from the application dashboard by selecting the three-dot menu (**…**) in the top-right corner, where you will find options to **Edit, Instant Rollback, Scale, Pause, or Delete** the deployment. Additionally, you can navigate through the dashboard tabs to: * View deployment history * Access and download logs * Add a custom domain * View and manage environment variables ## Conclusion Following these steps, you have successfully deployed an Express.js application with a **Dockerfile** on Clouddley. This method ensures a consistent, scalable, and efficient deployment workflow. Check out the source code for this application [here](https://github.com/clouddley/examples/tree/main/nodejs/express). # Using Multiple Ports in Your App Deployment Learn how to use multiple ports in your app deployment on Clouddley. Until now, when you deployed an app on Clouddley, you could only publish one port. That worked fine for simple apps, but many modern applications need more than one way to connect. We’ve listened, and we’ve made it better. Clouddley now supports multiple ports. This means you can run apps that expose both HTTP and gRPC, or any combination your workload needs, without extra workarounds. ### Why this matters Developers often build apps that serve different types of traffic. For example: * A web app that uses **HTTP** for users and **gRPC** for internal services * An API that exposes **REST** on one port and an **admin dashboard** on another * A service that needs to handle both **secure** and **non-secure** connections With multiple port support, Clouddley makes these setups simple. You don’t have to split workloads or hack around the limitations anymore. ### How it works When you deploy your app, you can now define more than one port. Each port can handle its own traffic type, and Clouddley will manage the routing for you. It’s as easy as adding another port in your configuration. ### Example: Using Multiple Ports In this example, your app needs to handle traffic on both HTTP (80) and HTTPS (443). You can set this up during app deployment with Clouddley. In **Step 4: Configure App settings**. Add both ports to the ports field.

Multiple port configuration for an app with port 80 & 443. — Multiple ports configured as a port in app settings

{% hint style="info" %} List the ports with a comma and no spaces in between. {% endhint %} ### What’s next This is part of our bigger goal: to give you flexibility without complexity. Multiple port support helps you build and scale apps the way they’re meant to run. Try it out today and see how much smoother your deployments can be. # Databases An overview of deploying databases on Clouddley, including its key features to help you get started.

Image of Databases dashboard on Clouddley. — Databases Dashboard

### Overview Databases represent your database workloads deployed on Clouddley running on virtual machines, servers, and bare metal with zero downtime. It automatically creates your selected database engine, whether it's **PostgreSQL, Redis, MongoDB, or others,** and provisions it using cloud-native tooling. It simplifies database setup, maintenance, and security. ### Key Features Here are the key features supported by Databases; * **Support for Multiple Databases**\ Whether you’re working with PostgreSQL, MySQL, MongoDB, or Redis, you can easily deploy and manage them all in one place. * **Real-Time Database Logs**\ Stay on top of performance and troubleshoot issues quickly with detailed logging. * **Password reset**\ Easily reset passwords for users securely with built-in authentication and encryption. * **Supports delete protection**\ Prevent accidental data loss, which safeguards against unintended deletions. # How-to Guides Learn how to deploy different databases to Clouddley.


Deploy a MongoDB Database on Clouddley	/files/inPID5KwBlYF0jtKQZ1w	/pages/XfcDMTeF3kHX7hiRl8Mk	/pages/XfcDMTeF3kHX7hiRl8Mk
Deploy a MariaDB Database on Clouddley	/files/jh0WCfuwKqx7bvKBgHWb	/pages/wgK26AhK3OR9xHwjFLFg	/pages/wgK26AhK3OR9xHwjFLFg
Deploy a PostgreSQL Database on Clouddley	/files/GCJSaLKpRpxjUSpcKOmZ		/pages/La5PJv6Jql29becMEyKH
Deploy a Redis Database on Clouddley	/files/8tXu24DWRahkfIIpF6eG		/pages/4iDIOxnxGTQ2PakQNZXk
Deploy a MySQL Database on Clouddley	/files/IXX9wMYMyWGiHACQu5uv		/pages/dvbPO2nO4qZz4zCJ2foe

# Deploy a MongoDB Database on Clouddley Learn how to deploy a MongoDB database on Clouddley. With [Clouddley](https://clouddley.com/triggr), you can easily deploy and manage a [MongoDB](https://www.mongodb.com/) database, a flexible and scalable NoSQL database designed for handling large volumes of data. This guide walks you through the steps to set up a MongoDB database on Clouddley. Whether you are a beginner or an experienced developer, your database will be up and running quickly. ## Prerequisites * A [Clouddley](https://clouddley.com/) account * A virtual machine on a Cloud platform or bare metal server. ## Step-by-step deployment {% stepper %} {% step %} ### Accessing Databases * Log in to your [Clouddley](https://clouddley.com/) account. * Navigate to [**Databases**](https://app.clouddley.com/services) and Click on **Deploy Database**

{% endstep %} {% step %} ### Configure your Virtual Machine (VM) In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the required details:


VM Host	Provide the host address of your virtual machine
VM User	Input the username required to access the virtual machine
Port	Specify the port number for the connection

* Use the **Clouddley CLI** (recommended) or connect via **SSH** to verify. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Run the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify** to validate the details and confirm the connection. * Click on **Next** to continue the setup process.

Configuring the virtual machine during database deployment on Clouddley. — Configuring the virtual machine to host your database

{% endstep %} {% step %} ### Database Name * Please enter a unique **name** for your database to distinguish it within the virtual machine (VM). * Click on **Next**

Configuring database name on Clouddley. — Defining a unique name for the MongoDB database

{% endstep %} {% step %} ### Select the Database type and version * Choose **MongoDB** database * Choose the desired **version** from the dropdown menu to ensure compatibility with your application. * (Optional) Enable the **Delete Protection** option to safeguard your MongoDB database from accidental deletion. {% hint style="info" %} This feature prevents the database from being destroyed unless explicitly disabled. {% endhint %} * Click on **Deploy DB**

User selecting the MongoDB database type and version. — Selecting the MongoDB database type and specifying the version for deployment

{% endstep %} {% step %} ### Confirm Deployment * Once the deployment process is complete, your **MongoDB database** is ready. * Click **Go to Dashboard** to access and manage your database.

Image of MongoDB database deployed successfully on Clouddley. — MongoDB database successfully deployed

{% endstep %} {% endstepper %} ## Database Dashboard You can access and manage your database through the user-friendly dashboard. {% tabs %} {% tab title="Overview" %} View details about your database, VM, and settings (e.g., Delete Protection), and use the option to delete the database if it is no longer needed.

An image of the overview section of the MongoDB database deployed on Clouddley. — The dashboard overview with a high-level summary of database performance and status

{% endtab %} {% tab title="Connections" %} Access public and private network details, including **username**, **password**, **host**, **port**, and **database** type.

An image of the connections section of the MongoDB database deployed on Clouddley. — View the public and private network connections to the MongoDB database

{% endtab %} {% tab title="Logs" %} Monitor real-time log streams for troubleshooting and download logs for further analysis.

An image of the logs section of the MongoDB database deployed on Clouddley. — Real-time logs for insights into database activity

{% endtab %} {% tab title="Users" %} Manage a list of database users and securely reset passwords as needed.

An image of the users section of the MongoDB database deployed on Clouddley. — Manage database users through the dashboard's users section

{% endtab %} {% endtabs %} ## Conclusion Clouddley makes database hosting effortless with its scalable, reliable, and user-friendly platform. It simplifies database management so you can focus on your applications. Check out our other articles to learn [how to deploy and manage different databases](/databases/how-to-guides) on the Clouddley.
# Deploy a MariaDB Database on Clouddley Learn how to deploy a MariaDB database on Clouddley. Setting up and managing a [MariaDB](https://mariadb.org/) database is simple and efficient with [Clouddley](https://clouddley.com/triggr). MariaDB is a powerful, open-source relational database known for its speed and reliability. This guide walks you through the deployment process on Clouddley, making it easy for beginners and experienced developers to get their database up and running quickly. ## Prerequisites * A [Clouddley](https://clouddley.com/) account. * A virtual machine on a Cloud platform or a bare metal server. ## Step-by-step deployment {% stepper %} {% step %} ### Accessing Databases * Log in to your [Clouddley](https://clouddley.com/) account. * Navigate to [**Databases**](https://app.clouddley.com/services) and Click on **Deploy Database**


VM Host	Provide the host address of your virtual machine.
VM User	Input the username required to access the virtual machine
Port	Specify the port number for the connection

* Use the **Clouddley CLI** (recommended) or connect via **SSH** to verify. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify** to validate the details and confirm the connection. * Click **Next** to proceed.

{% endstep %} {% step %} ### Database Name * Enter a unique **name** for your database for easy identification within the virtual machine (VM). * Click on **Next**

{% endstep %} {% step %} ### Select the Database type and version * Select **MariaDB** from the dropdown menu * Select the preferred **version** from the dropdown menu to ensure compatibility with your application. * (Optional) Enable the Delete Protection option to prevent accidental deletion of your MariaDB database. {% hint style="info" %} This feature prevents the database from being destroyed unless explicitly disabled. {% endhint %} * Click on **Deploy DB**

User selecting the MariaDB database type and version. — Selecting the MariaDB database type and specifying the version for deployment

{% endstep %} {% step %} ### Confirm Deployment * Once the deployment is complete, your MariaDB database is ready. * Click **Go to Dashboard** to access and manage your database.

Image of MariaDB database deployed successfully on Clouddley. — MariaDB database successfully deployed

{% endstep %} {% endstepper %} ## Database Dashboard You can access and manage your database using the user-friendly dashboard interface. {% tabs %} {% tab title="Overview" %} View details about your database, VM, and settings (e.g., Delete Protection), and use the option to delete the database if it is no longer needed.

An image of the overview section of the MariaDB database deployed on Clouddley.. — The dashboard overview with a high-level summary of database performance and status

{% endtab %} {% tab title="Connections" %} Access public and private network details, including username, password, host, port, and database type.

An image of the connections section of the MariaDB database deployed on Clouddley. — View the public and private network connections to the MariaDB database

{% endtab %} {% tab title="Logs" %} Monitor real-time log streams for troubleshooting and download logs for further analysis.

An image of the logs section of the MariaDB database deployed on Clouddley. — Real-time logs for insights into database activity

{% endtab %} {% tab title="Users" %} Manage a list of database users and securely reset passwords as needed.

An image of the users section of the MariaDB database deployed on Clouddley. — Manage database users through the dashboard's users section

{% endtab %} {% endtabs %} ## Conclusion Clouddley makes deploying a MariaDB database easy and hassle-free, allowing you to focus on your applications instead of database management. Explore our [other guides](/databases/how-to-guides) to learn how to deploy different databases on Clouddley. # Deploy a PostgreSQL Database on Clouddley. Learn how to deploy a PostgreSQL database on Clouddley. Deploying and managing a [PostgreSQL](https://www.postgresql.org/) database is easy with [Clouddley](https://clouddley.com/triggr). PostgreSQL is a powerful open-source relational database known for its robustness and extensibility. This guide walks you through the setup process on Clouddley, ensuring a smooth and efficient deployment experience for developers of all skill levels. ## Prerequisites * A [Clouddley](https://clouddley.com/) account * A virtual machine on a Cloud platform or a bare metal server. ## Step-by-step deployment {% stepper %} {% step %} ### Accessing Databases * Log in to your [Clouddley](https://clouddley.com/) account. * Navigate to [**Databases**](https://app.clouddley.com/services) and Click on **Deploy Database**


VM Host	Provide the host address of your virtual machine.
VM User	Input the username required to access the virtual machine
Port	Specify the port number for the connection

* Use the **Clouddley CLI** (recommended) or connect via **SSH** to verify. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click **Verify** to validate the details and confirm the connection. * Click **Next** to continue.

{% endstep %} {% step %} ### Database Name * Provide a unique **name** for your database to ensure easy identification within the virtual machine (VM). * Click **Next** to proceed.

{% endstep %} {% step %} ### Select the Database type and version * Choose **PostgreSQL** from the dropdown menu * Select your preferred version to ensure compatibility with your application. * (Optional) Enable the Delete Protection option to prevent accidental deletion of your PostgreSQL database. {% hint style="info" %} This feature prevents the database from being destroyed unless explicitly disabled. {% endhint %} * Click on **Deploy DB**

User selecting the PostgreSQL database type and version. — Selecting the PostgreSQL database type and specifying the version for deployment

{% endstep %} {% step %} ### Confirm Deployment * After the deployment is complete, your PostgreSQL database is ready. * Click **Go to Dashboard** to access and manage it.

Image of PostgreSQL database deployed successfully on Clouddley. — PostgreSQL database successfully deployed

An image of the overview section of the PostgreSQL database deployed on Clouddley. — The dashboard overview with a high-level summary of database performance and status

{% endtab %} {% tab title="Connections" %} Access public and private network details, including username, password, host, port, and database type.

An image of the connections section of the PostgreSQL database deployed on Clouddley. — View the public and private network connections to the PostgreSQL database

{% endtab %} {% tab title="Logs" %} Monitor real-time log streams for troubleshooting and download logs for further analysis.

An image of the logs section of the PostgreSQL database deployed on Clouddley. — Real-time logs for insights into database activity

{% endtab %} {% tab title="Users" %} Manage a list of database users and securely reset passwords as needed.

An image of the users section of the PostgreSQL database deployed on Clouddley. — Manage database users through the dashboard's users section

{% endtab %} {% endtabs %} ## Conclusion Deploying a PostgreSQL database on Clouddley is quick, efficient, and scalable. With its database management features, you can focus on your applications while Clouddley handles the heavy lifting. Check out our [other guides](/databases/how-to-guides) to learn how to deploy various databases on Clouddley. # Deploy a Redis Database on Clouddley Learn how to deploy a Redis database on Clouddley. [Clouddley](https://clouddley.com/triggr) makes it easy to deploy and manage a [Redis](https://redis.io/) database, a high-performance in-memory data store known for its speed and versatility. This guide walks you through the deployment process on Clouddley, you'll have your database up and running quickly. ## Prerequisites * A [Clouddley](https://clouddley.com/) account * A virtual machine on a Cloud platform or bare metal server. ## Step-by-step deployment {% stepper %} {% step %} ### Accessing Databases * Log in to your [Clouddley](https://clouddley.com/) account. * Navigate to [**Databases**](https://app.clouddley.com/services) and Click on **Deploy Database**

{% endstep %} {% step %} ### Configure the Virtual Machine (VM) In the Choose or add server dropdown, select your virtual machine (VM) if it’s already listed. If not, select **+ Add Virtual Machine**. Enter the required details:


VM Host	Provide the host address of your virtual machine.
VM User	Input the username required to access the virtual machine
Port	Specify the port number for the connection

* Use the **Clouddley CLI** (recommended) or connect via **SSH** to verify. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Triggr to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify** to validate the details and confirm the connection. * Click **Next** to proceed.

{% endstep %} {% step %} ### Database Name * Enter a unique **name** for your database for easy identification within the virtual machine (VM). * Click on **Next**

{% endstep %} {% step %} ### Select the Database type and version * Select **Redis** from the dropdown menu * Select the preferred **version** from the dropdown menu to ensure compatibility with your application. * (Optional) Enable the Delete Protection option to prevent accidental deletion of your MariaDB database. {% hint style="info" %} This feature prevents the database from being destroyed unless explicitly disabled. {% endhint %} * Click on **Deploy DB**

User selecting the Redis database type and version. — Selecting the Redis database type and specifying the version for deployment

{% endstep %} {% step %} ### Confirm Deployment * Once the deployment is complete, your Redis database is ready. * Click **Go to Dashboard** to access and manage your database.

Image of Redis database deployed successfully on Triggr Databases. — Redis database successfully deployed

An image of the overview section of the Redis database deployed on Clouddley. — The dashboard overview with a high-level summary of database performance and status

{% endtab %} {% tab title="Connections" %} Access public and private network details, including username, password, host, port, and database type.

An image of the connections section of the Redis database deployed on Clouddley. — View the public and private network connections to the Redis database

{% endtab %} {% tab title="Logs" %} Monitor real-time log streams for troubleshooting and download logs for further analysis.

An image of the logs section of the Redis database deployed on Clouddley. — Real-time logs for insights into database activity

{% endtab %} {% tab title="Users" %} Manage a list of database users and securely reset passwords as needed.

An image of the users section of the Redis database deployed on Clouddley. — Manage database users through the dashboard's users section

{% endtab %} {% endtabs %} ## Conclusion Deploying a Redis database on Clouddley provides a fast, scalable, and hassle-free solution for database management. It ensures high performance and reliability, allowing you to focus on building and running your applications. Check out our[ other guides](/databases/how-to-guides) to learn more about deploying other database types on Clouddley. # Deploy a MySQL Database on Clouddley Learn how to deploy a MySQL database on Clouddley. With [Clouddley](https://clouddley.com/triggr), you can easily deploy and manage a [MySQL](https://www.mysql.com/) database, a widely used open-source relational database known for its reliability and performance. This guide walks you through setting up a MySQL database on Clouddley. Whether you're a beginner or an experienced developer, you'll have your database running smoothly in no time. ## Prerequisites * A [Clouddley](https://clouddley.com/) account * A virtual machine on a Cloud platform or bare metal server. ## Step-by-step deployment {% stepper %} {% step %} ### Accessing Databases * Log in to your [Clouddley](https://clouddley.com/) account. * Navigate to [**Databases**](https://app.clouddley.com/services) and Click on **Deploy Database**

Image of Triggr Databases dashboard. — Accessing Databases


VM Host	Provide the host address of your virtual machine.
VM User	Input the username required to access the virtual machine
Port	Specify the port number for the connection

* Use the **Clouddley CLI** (recommended) or connect via **SSH** to verify. {% tabs %} {% tab title="Clouddley CLI" %} The Clouddley CLI is a command-line tool that allows you to interact with the Clouddley Platform from your terminal. * Open the command line of the remote VM you want to configure to Clouddley and install Clouddley CLI by running the command: ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` * To add the SSH public key, run the command: ```bash clouddley add key ``` Using the CLI, you can deploy resources, manage configurations, and automate tasks efficiently. {% endtab %} {% tab title="SSH" %} * Download the public key to your local machine. * Ru**n** the provided command on your local machine, allowing Clouddley to connect to your virtual machine. ``` ssh-copy-id -f -i ~/path/to/downloaded/Publickey username@ipaddress ``` {% hint style="info" %} Replace `~/path/to/downloaded/Publickey` ,`username` and `ipaddress` with your actual values. {% endhint %} {% endtab %} {% endtabs %} * Click on **Verify** to validate the details and confirm the connection. * Click **Next** to proceed.

{% endstep %} {% step %} ### Database Name * Enter a unique **name** for your database for easy identification within the virtual machine (VM). * Click on **Next**

{% endstep %} {% step %} ### Select the Database type and version * Select MySQL from the dropdown menu * Select the preferred **version** from the dropdown menu to ensure compatibility with your application. * (Optional) Enable the Delete Protection option to prevent accidental deletion of your MariaDB database. {% hint style="info" %} This feature prevents the database from being destroyed unless explicitly disabled. {% endhint %} * Click on **Deploy DB**

User selecting the MySQL database type and version. — Selecting the MySQL database type and specifying the version for deployment

{% endstep %} {% step %} ### Confirm Deployment * Once the deployment is complete, your Redis database is ready. * Click **Go to Dashboard** to access and manage your database.

Image of MySQL database deployed successfully on Clouddley. — MySQL database successfully deployed

An image of the overview section of the MySQL database deployed on Clouddley. — The dashboard overview with a high-level summary of database performance and status

{% endtab %} {% tab title="Connections" %} Access public and private network details, including username, password, host, port, and database type.

An image of the connections section of the MySQL database deployed on Clouddley. — View the public and private network connections to the MySQL database

{% endtab %} {% tab title="Logs" %} Monitor real-time log streams for troubleshooting and download logs for further analysis.

An image of the logs section of the MySQL database deployed on Clouddley. — Real-time logs for insights into database activity

{% endtab %} {% tab title="Users" %} Manage a list of database users and securely reset passwords as needed.

An image of the users section of the MySQL database deployed on Clouddley. — Manage database users through the dashboard's users section

{% endtab %} {% endtabs %} ## Conclusion Clouddley simplifies MySQL database deployment with its user-friendly interface, automated management, and scalable infrastructure. Whether you're handling small projects or large-scale applications, Clouddley ensures your database is properly managed. Explore our [other guides](/databases/how-to-guides) to discover more about deploying other databases on Clouddley. # Extras Find out more features and details about Databases. {% content-ref url="/pages/iBwcdazHxv8GUUGW5teB" %} [Database Networking on Clouddley](/databases/extras/database-networking-on-clouddley) {% endcontent-ref %} {% content-ref url="/pages/itu8C0vwa3hLS2PtCLaz" %} [How to Reset Database Password on Clouddley](/databases/extras/how-to-reset-database-password-on-clouddley) {% endcontent-ref %} # Database Networking on Clouddley Learn about database networking on Clouddley Database networking determines how your database communicates with applications and other services. Clouddley provides detailed configurations for **public** and **private** networks, allowing users to use the best option based on their needs. This article covers the key differences and how to select the appropriate database network type on Clouddley. ## Understanding public and private networks Understanding the differences between public and private networks helps ensure the right database networking choice is made based on security, performance, and accessibility requirements. ### Public Network A public network allows external access to a database over the Internet, enabling remote connections for external applications and third-party integrations. However, it increases exposure to security threats, requiring strict measures such as IP whitelisting, firewall rules, and encryption. Additionally, internet traffic may introduce latency. ### Private Network A private network keeps database connections within a secure environment, preventing direct internet access. It supports internal communication, microservices architectures, and enterprise systems with strict security policies. This setup reduces exposure to unauthorised access, improves connection speed and reliability, and enhances access control within a controlled environment. #### Connecting over the private network When configuring your database connection over the private network, you can set the host to either the **database name** (for internal connections only) or the **private IP address.** {% hint style="info" %} The **database name** is the one you configured when creating your database on Clouddley. {% endhint %}

Image highlighting the Database Name in the overview tab's database information section. — The database name in your database’s Overview tab.

## Database Network Settings on Clouddley Clouddley provides details for both **public** and **private** networks, allowing users to utilise them as needed for their database connections.

Public and Private network for Databases on Clouddley — Database networking connections tab.

**Choosing the Right Network Type** Users can use both public and private networks depending on their needs: * **Public networks** are functional for remote access and integrations. * **Private networks** offer secure, internal connectivity. **Using the Public Network** 1. Retrieve the public connection details from Clouddley. **Using the Private Network** 1. Retrieve private network details from Clouddley. 2. Ensure internal applications and services have the correct network permissions. 3. Use private IP addresses or VPC peering for secure connections. ## Conclusion Clouddley provides users with public and private network details, ensuring flexibility in database connectivity. Public networks allow external access but require strict security controls, while private networks enhance security by keeping connections internal. By implementing best practices such as access restrictions and encryption, users can maintain a secure and optimised database network. # How to Reset Database Password on Clouddley Learn how to reset your database password on Clouddley Resetting a database password is sometimes necessary for security or access recovery. With Clouddley, the process is simple and secure. This article walks you through the steps to reset your database password. ## Steps to Reset a Database Password For this, we will be resetting the password of a PostgreSQL database user. {% stepper %} {% step %} Navigate to the Databases dashboard and click on the database.

Clouddley database dashboard — Selecting the database to reset the password on the Clouddley dashboard

{% endstep %} {% step %} In the **Users** tab, navigate to the **Actions** column, click the three-dot menu, and select **Reset Database**.

PostgreSQL users tab displaying all users. — Users tab displaying a list of all active users.

{% endstep %} {% step %} Input the **database name** and click on **Reset Password**.

Reset database user password on Clouddley pop up. — Entering the database name for password reset.

{% endstep %} {% endstepper %} Once you see this pop-up, you've successfully reset your Database password.

Successful password reset confirmation. — Image of a successful password reset

## Considerations After Resetting the Password Once the password reset is successful, existing active connections will remain unaffected. However, users must log in again with the new password for any new sessions. To ensure a smooth transition and maintain security, consider the following: * **Update Stored Credentials**: To avoid connection issues, update applications and services using the database with the new password. * **Verify Access**: To confirm if the update was successful, test the new credentials by logging in. * **Monitor for Unauthorized Access**: Check database logs for any failed login attempts, as old credentials may still be in use. ## Conclusion Resetting a database password is a straightforward process on Clouddley, ensuring secure access without disrupting active connections. You can maintain smooth database operations by updating credentials in connected applications, verifying access, and following security best practices. # Servers An overview of Servers on Clouddley

Image of servers dashboard on Clouddley — Servers on Clouddley

Servers represent your compute resources connected to Clouddley for deploying applications and workloads. Whether it’s **VMs, bare metal,** or **cloud instances** like **AWS EC2 instances, Azure Virtual Machines, GCP Compute Engine, or DigitalOcean droplets,** Servers provide a way to add the compute resource on Clouddley. It simplifies the deployment process across different environments and platforms. ### Key Features Here are the key features supported by Servers: * **Connect to any Linux server**\ Add Linux-based servers from any hosting provider. * **Deploy with one click.**\ Deploy applications and workloads across servers without writing custom scripts or manually accessing each machine via SSH. * **Secure connections**\ All server communication uses SSH encryption with automated key handling and immediate access revocation capabilities. * **Resource cleanup**\ Remove unused Docker images and containers to reclaim disk space on your servers. * **Quick setup**\ Connect new servers in under a minute using our command-line tool with minimal configuration steps. # Add Servers Learn how to add on Clouddley. In Clouddley, a server is any compute resource (**VM, bare metal, or cloud instance**) where you deploy your workloads to. Servers lets you manage workloads from one place, deploy faster, and monitor everything together. By adding your servers to Clouddley, you can see the compute resources in use on your Clouddley account. This guide walks you through adding new servers to Clouddley and removing existing ones. ### Prerequisites Before you begin, make sure you have: * Have a [Clouddley](https://app.clouddley.com/) account * Have a server with its details: * VM host * VM port * VM user * Basic familiarity with the command-line ### Add a Server To add a server to your Clouddley account: 1. Sign in to your **Clouddley** account 2. Select **Servers** 3. Select **+** **Add Server** 4. Enter a **name** for the server 5. Complete the **VM host**, **VM user**, and **VM port** fields 6. Run the installation commands on your remote machine: **Install Clouddley CLI** ```bash curl -L https://raw.githubusercontent.com/clouddley/cli/main/install.sh | sh ``` **Add the SSH public key to the remote server** ``` clouddley add key ``` {% hint style="info" %} Ensure you have the necessary permissions to run these commands. {% endhint %} 7. Click on **Save**

Create server form — Creating a server on Clouddley

You've successfully created a server on Clouddley! ### Troubleshooting Common Issues

Connection fails during setup

* Check that your VM host, port, and user details are correct * Make sure port 22 (SSH) is open on your server * Verify your server allows SSH connections

Permission denied when running commands

* Make sure your user has sudo privileges * Check that you're using the correct username for your server

Server shows offline

* Confirm your server is running and accessible * Try reconnecting by running the installation commands again

### Security Considerations When you add a server to Clouddley: * Clouddley adds its SSH public key to your server's authorized keys. * All communication happens over encrypted SSH connections. * You can revoke access by removing the Clouddley public key from your server. {% hint style="info" %} Note that revoking access disrupts the connection between Clouddley and your server. {% endhint %} ### Best Practices * Server naming: Use descriptive names that help you quickly identify your servers. * Regular maintenance: Run the cleanup regularly to free up disk space. # Remove Servers Learn how to remove servers from Clouddley. To remove a server from Clouddley: 1. Select the server you want to delete. 2. In the upper-right corner, select **Delete.** 3. Enter the server name and click **Delete Server.**

Your server has been successfully removed! # Clean Up Servers Learn how to clean up docker images from servers on Clouddley. Over time, unused Docker images can consume a significant amount of disk space on your servers on Clouddley. Cleaning them up helps free resources and keep the servers running smoothly. Here is how to clean up your server: 1. Select the server you want to clean up. 2. At the bottom of the overview, click on **Clean Up**. 3. Enter the server **name**. 4. Click on **Clean Up Server.**

A gif showing how to clean up servers on Clouddley

Once the cleanup is complete, it returns to the server’s overview page. # Databases # Supported PostgreSQL Extensions A quick reference guide to all PostgreSQL extensions supported by Clouddley. [PostgreSQL](https://www.postgresql.org/) is an open-source, object-relational database management system renowned for its extensibility, data integrity, and performance. The system maintains full ACID (Atomicity, Consistency, Isolation, Durability) compliance through its concurrency support and enables customisation through dynamic loading and catalogue-driven operations. {% hint style="info" %} [Extensions](https://www.postgresql.org/docs/current/extend-extensions.html) are pre-packaged collections of SQL objects that enhance PostgreSQL functionality, allowing users to add specialised features to their database without modifying the core system. {% endhint %} ### Managing PostgreSQL Extensions Before running the commands below, log in to your PostgreSQL database using `psql`: ``` psql -h -p -U -d ``` {% hint style="info" %} Replace the placeholder values above with your actual database connection details. {% endhint %} Once connected, you can manage PostgreSQL extensions in Databases using the following commands: * Installing supported extensions command:
```bash CREATE EXTENSION ; ``` * Upgrading extensions command:
```bash ALTER EXTENSION UPDATE; ``` * Disable extensions command:

DROP EXTENSION <extension-name>;

* List currently installed extensions command:
```bash \dx ``` ### Available Extensions To see what extensions are available in your database, you can run this command from the command line using **psql**: ```bash SELECT * FROM pg_available_extensions; ```

View Available Extensions - Example

You can find your connection details on your Database dashboard:

**Example with sample values:** Log in using psql by running this command: ``` psql -h 78.47.225.173 -p 14295 -U triggradmin -d postgres ``` Once you are connected, run the command: ``` SELECT * FROM pg_available_extensions; ``` You will see an output like the one below ``` name | default_version | installed_version | comment ------------------------------+-----------------+-------------------+--------------------------------------------------------------------------------------------------------------------- sslinfo | 1.2 | | information about SSL certificates cube | 1.5 | | data type for multidimensional cubes citext | 1.6 | | data type for case-insensitive character strings seg | 1.4 | | data type for representing line segments or floating-point intervals btree_gist | 1.7 | | support for indexing common datatypes in GiST plpgsql | 1.0 | 1.0 | PL/pgSQL procedural language xml2 | 1.1 | | XPath querying and XSLT insert_username | 1.0 | | functions for tracking who changed a table ```

Clouddley PostgreSQL Database comes with support for the PostgreSQL extensions listed below.

Extension Name	Description
address_standardizer	Used to parse an address into constituent elements. Generally used to support geocoding address normalization step.
address_standardizer_data_us	Address Standardizer US dataset example
adminpack	administrative functions for PostgreSQL
amcheck	functions for verifying relation integrity
autoinc	functions for autoincrementing fields
bloom	bloom access method - signature file based index
btree_gin	support for indexing common datatypes in GIN
btree_gist	support for indexing common datatypes in GiST
citext	data type for case-insensitive character strings
cube	data type for multidimensional cubes
dblink	connect to other PostgreSQL databases from within a database
dict_int	text search dictionary template for integers
dict_xsyn	text search dictionary template for extended synonym processing
earthdistance	calculate great-circle distances on the surface of the Earth
file_fdw	foreign-data wrapper for flat file access
fuzzystrmatch	determine similarities and distance between strings
hstore	data type for storing sets of (key, value) pairs
insert_username	functions for tracking who changed a table
intagg	integer aggregator and enumerator (obsolete)
intarray	functions, operators, and index support for 1-D arrays of integers
isn	data types for international product numbering standards
lo	Large Object maintenance
ltree	data type for hierarchical tree-like structures
moddatetime	functions for tracking last modification time
old_snapshot	utilities in support of old_snapshot_threshold
orafce	Functions and operators that emulate a subset of functions and packages from the Oracle RDBMS
pageinspect	inspect the contents of database pages at a low level
pg_buffercache	examine the shared buffer cache
pg_freespacemap	examine the free space map (FSM)
pg_prewarm	prewarm relation data
pg_stat_statements	track planning and execution statistics of all SQL statements executed
pg_surgery	extension to perform surgery on a damaged relation
pg_trgm	text similarity measurement and index searching based on trigrams
pg_visibility	examine the visibility map (VM) and page-level visibility info
pg_walinspect	functions to inspect contents of PostgreSQL Write-Ahead Log
pgaudit	provides auditing functionality
pgautofailover	pg_auto_failover
pgcrypto	cryptographic functions
pgrowlocks	show row-level locking information
pgstattuple	show tuple-level statistics
pljava	PL/Java procedural language (https://tada.github.io/pljava/)
plpgsql	PL/pgSQL procedural language
postgis	PostGIS geometry and geography spatial types and functions
postgis_raster	PostGIS raster types and functions
postgis_tiger_geocoder	PostGIS tiger geocoder and reverse geocoder
postgis_topology	PostGIS topology spatial types and functions
postgres_fdw	foreign-data wrapper for remote PostgreSQL servers
refint	functions for implementing referential integrity (obsolete)
seg	data type for representing line segments or floating-point intervals
sslinfo	information about SSL certificates
tablefunc	functions that manipulate whole tables, including crosstab
tcn	Triggered change notifications
tsm_system_rows	TABLESAMPLE method which accepts number of rows as a limit
tsm_system_time	TABLESAMPLE method which accepts time in milliseconds as a limit
unaccent	text search dictionary that removes accents
uuid-ossp	generate universally unique identifiers (UUIDs)
xml2	XPath querying and XSLT