# Install Application

This document explains how to quickly install applications using the App Launchpad feature in ClawCloud Run.

## Installing Nginx

1. **Launch ClawCloud Run**\
   Open ClawCloud Run and locate the App Launchpad application.

<figure><img src="https://2509840198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrViHKCGxzpwUEsRBfwlN%2Fuploads%2FSYqTIx6G2ZKhiF16ZDfe%2Fimage.png?alt=media&#x26;token=15c11577-9cc5-4091-bf96-72d35d6710a2" alt=""><figcaption></figcaption></figure>

2. **Create a New Application**\
   In the App Launchpad interface, click the **Create App** button. In the deployment form, fill in the following details:

* **Application Name:** Enter the desired name for your app.
* **Image Name:** Specify the container image (e.g., `nginx:latest`).
* **Deployment Mode:** Choose between a fixed number of instances or auto-scaling.
* **Compute Resources:** Adjust CPU and memory settings using the slider.
* **Network Configuration:** Enter the container port and decide whether to enable external access.
* **Startup Command:** Optionally customize the startup command and its parameters.
* **Environment Variables:** Optionally set custom environment variables.
* **Configuration Files:** Mount configuration files into the container if needed.
* **Storage Capacity:** If persistent storage is required, specify the amount to mount.

<figure><img src="https://2509840198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrViHKCGxzpwUEsRBfwlN%2Fuploads%2FdcL4dWWuyfsX5HspLyVQ%2Fimage.png?alt=media&#x26;token=8a41eb0a-4903-4373-8b5f-6b9a5b5554c9" alt=""><figcaption></figcaption></figure>

**Example Configuration for Installing Nginx**\
For installing Nginx, enter the following details:

* **Application Name:** nginx
* **Image Name:** nginx:latest
* **Deployment Mode:** Fixed instance with 1 instance
* **Compute Resources:** 0.1 vCPU and 128 MB memory
* **Network Configuration:** Port 80 with external access enabled

Leave the remaining fields blank. Then, click the **Deploy Application** button in the top-right corner and wait for the deployment to complete.

<figure><img src="https://2509840198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrViHKCGxzpwUEsRBfwlN%2Fuploads%2FoXkZ4XiZQ7IsQQ1wJnD9%2Fimage.png?alt=media&#x26;token=8838626e-e0a0-4a6c-9929-504ab78bffbf" alt=""><figcaption></figcaption></figure>

3. **Post-Deployment Details**\
   Once deployed, you'll be directed to the application details page where you can view the application's access address, status, logs, and more. When the application instance status becomes **running**, click the **Public Address** to access the Nginx service.

<figure><img src="https://2509840198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrViHKCGxzpwUEsRBfwlN%2Fuploads%2F5679TRPubnJkHlS3fJJF%2Fimage.png?alt=media&#x26;token=d6e5aa39-adea-4ff8-9108-b25112a2a258" alt=""><figcaption></figcaption></figure>

3. **Managing Application Instances**\
   In the instance list, you will find several buttons:

   * **Logs:** View the logs for the application instance.
   * **Terminal:** Access the terminal of the application instance.
   * **Details:** View detailed startup information of the application instance.
   * **Restart:** Restart the application instance.

   If the instance fails to start (e.g., the status shows **waiting**), click the **Details** button to diagnose the issue, such as an incorrect image name.

<figure><img src="https://2509840198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrViHKCGxzpwUEsRBfwlN%2Fuploads%2FZ03HzJR56vy8d0mXe2JX%2Fimage.png?alt=media&#x26;token=e85f0dba-a70d-4f93-91d0-f5bfc61c6479" alt=""><figcaption></figcaption></figure>

3. **Usage of the Management Buttons**
   * **Logs Button:** Click this to check for errors during startup or runtime.
   * **Terminal Button:** Click this to open a terminal session within the container for executing commands.
   * **Restart Button:** Use this to restart the application instance, which may resolve transient issues.

<figure><img src="https://2509840198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrViHKCGxzpwUEsRBfwlN%2Fuploads%2FZrmbe5gUWPnD1gexVoKb%2Fimage.png?alt=media&#x26;token=dbb95ef3-b613-402c-bc79-eb33fe0b4116" alt=""><figcaption></figcaption></figure>

By following these steps, you can quickly deploy and manage your Nginx service using the App Launchpad in ClawCloud Run.