Quick Start Guide

2 min read Updated 1 month ago

Deploy Your First Application

This guide will walk you through deploying your first application to Ploi Cloud. We'll use a Laravel application as an example, but the process is similar for other frameworks.

Step 1: Connect Your Repository

First, connect your code repository:

  1. Navigate to the Applications page
  2. Click "Create application"
  3. In the Repository step, select your connected provider (GitHub, GitLab, or Bitbucket)
  4. If you haven't connected a provider yet, click "Connect" to authorize access
  5. Choose your repository from the dropdown list

Step 2: Configure Your Application

In the Configuration step, set up your application:

  • Application name: Enter a name using lowercase letters, numbers, and hyphens (4-32 characters)
  • Region: Select your deployment region
  • Framework: Choose Laravel and select your PHP version
  • Build settings: Check "Add NPM run build commands" if you use Vite or Webpack for assets

Step 3: Add a Database (Optional)

In the Build & Services step, you can add a database:

  1. Toggle "Add a database" if your application needs one
  2. Choose from MySQL, PostgreSQL, or MongoDB
  3. The database connection details will be automatically added as environment secrets

Step 4: Complete Setup

Click "Create application" to finish. Your application will be created with:

  • A domain at https://your-app-name-xxxxxxxx.test.ploi.it
  • Build commands configured for your framework
  • Database service if selected

Step 5: Deploy Your Application

After creation, deploy your application:

  1. Click "Deploy now" in the getting started card
  2. Ploi Cloud will clone your repository
  3. Run your build commands (composer install, npm build)
  4. Build and deploy your application
  5. Configure SSL certificates automatically

Your application will show as "Active" when deployment completes. You can view deployment progress and logs in the Deployments tab.

If your deployment fails, check the deployment logs for error details or visit our troubleshooting guide for common solutions.

Next Steps

  • Add environment secrets in the Settings tab
  • Configure custom domains in the Network section
  • Add additional services like Redis or workers
  • Monitor your application logs and deployments