> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loupp.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Deploy and manage web applications on your servers in Loupp

## Overview

Sites in Loupp represent projects deployed on your servers. You can deploy multiple sites on a single server, each with its own domain, configuration, and deployment settings. The system supports both Laravel and static HTML/PHP applications with automated deployment from your source control repositories.

<Info>
  For information about server management and configuration, see **[Server Overview](/server/creation)** and **[Server Settings](/server/settings)**.
</Info>

## Creating a New Site

<Steps>
  <Step title="Access server sites">
    Navigate to your server dashboard and click on the "Sites" tab to access the sites management interface.
  </Step>

  <Step title="Configure basic site details">
    Fill in the essential site configuration:

    * **Domain**: Your website's domain name (e.g., loupp.dev or [www.loupp.dev](http://www.loupp.dev))
    * **Project Type**: Choose between Laravel or Static HTML/PHP
  </Step>

  <Step title="Set up source control">
    Configure your source control integration:

    * **Source Control**: Select from your connected source control providers
    * **Repository**: Enter your repository name
    * **Get Branches**: Click to fetch available branches from your repository
    * **Branch**: Select the deployment branch (defaults to first available branch)
  </Step>

  <Step title="Configure advanced settings (optional)">
    Customize additional configurations:

    * **Web Directory**: Set the web root directory (default: public)
    * **Web Server Templates**: Choose from your available server templates
  </Step>

  <Step title="Set up integrations (optional)">
    Configure optional integrations:

    * **Reverb**: Laravel Reverb (daemon configuration only)
    * **Queue Worker**: Basic Laravel queue worker
    * **Task Scheduler**: Basic Laravel scheduler:run
  </Step>

  <Step title="Deploy site">
    Click "Create Site" to begin site creation process.
  </Step>
</Steps>

## Site Configuration Options

### Application Types

Loupp supports two main application types:

<CardGroup cols={2}>
  <Card title="Laravel" icon="code">
    Full-featured PHP framework with built-in support for modern web applications, database integration, and advanced features.
  </Card>

  <Card title="Static HTML/PHP" icon="globe">
    Simple static websites or basic PHP applications with optional Composer dependency installation.
  </Card>
</CardGroup>

### Source Control Integration

Connect your sites to version control systems for automated deployments:

* **GitHub**: Connect your GitHub repositories
* **GitLab**: Integrate with GitLab projects
* **Bitbucket**: Connect Bitbucket repositories (note: not available in site creation only authentications)

<Info>
  Source control integration enables automatic deployments when you push changes to your configured branch. You must have source control configured in your settings before creating sites. See **[Source Control Settings](/settings/source-control)** for configuration details.
</Info>

<Warning>
  If you encounter source control errors, you'll need to go to your source control settings to reconnect or resolve authentication issues. Visit **[Source Control Settings](/settings/source-control)** to troubleshoot.
</Warning>

<Info>
  Learn more about managing web server templates in **[Server Templates](/settings/templates)**.
</Info>

### Integration Options

<AccordionGroup>
  <Accordion title="Reverb">
    Laravel Reverb. Note: This only sets the daemon configuration - you need to manually install Reverb.
  </Accordion>

  <Accordion title="Queue Worker">
    Basic Laravel queue worker.
  </Accordion>

  <Accordion title="Task Scheduler">
    Basic Laravel scheduler:run.
  </Accordion>
</AccordionGroup>

<Info>
  All integration options are optional and can be configured later. You can ignore these settings during initial site creation and set them up later.
</Info>

## Site Management

### Viewing Site Details

Once deployed, you can access comprehensive site information:

* **Application Overview**: Site status, domain, and basic information
* **Environment Variables**: Configure environment-specific settings
* **Deployment History**: Track all deployments and their status

### Site Actions

<AccordionGroup>
  <Accordion title="View Site">
    Access the site's main dashboard for detailed management and configuration.
  </Accordion>

  <Accordion title="Delete Site">
    Remove the site and all associated files from the server. This action queues the deletion process.
  </Accordion>
</AccordionGroup>

## Related Documentation

* **[Environment Variables](/sites/environment)** - Set up environment-specific configurations
* **[Deployments](/sites/deployments)** - Manage deployment processes and history
* **[Source Control Settings](/settings/source-control)** - Configure your source control integrations
* **[Server Templates](/settings/templates)** - Create and manage web server templates
* **[Queue Management](/sites/queue)** - Configure Laravel queue workers
* **[Site Logs](/sites/logs)** - View and troubleshoot site logs
* **[SSL Configuration](/sites/ssl)** - Set up SSL certificates for your sites
* **[Server Management](/server/creation)** - Learn about server setup and configuration
