> ## 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.

# SSL Configuration

> Install SSL certificates using Let's Encrypt or manual uploads

## Overview

Secure your websites with SSL certificates. Supports Let's Encrypt (free, automated) or manual certificate uploads.

## Features

<CardGroup cols={2}>
  <Card title="Let's Encrypt" icon="key">
    Free automated certificates with auto-renewal every 90 days
  </Card>

  <Card title="Manual Upload" icon="upload">
    Upload your own certificate files for full control
  </Card>
</CardGroup>

## Usage

### Let's Encrypt

<Steps>
  <Step title="Click install">
    Click "Install Let's Encrypt" button
  </Step>

  <Step title="Validation">
    System validates domain points to server IP
  </Step>

  <Step title="Installation">
    Certificate installs automatically (1-2 minutes)
  </Step>

  <Step title="Complete">
    Status shows "Active" when complete
  </Step>
</Steps>

<Info>
  **Requirements**: Domain must point to server IP, ports 80/443 accessible
</Info>

### Manual Upload

<Steps>
  <Step title="Open upload">
    Click "Upload Certificate" button
  </Step>

  <Step title="Upload files">
    Upload certificate (.crt, .pem, .txt) and private key (.key, .pem, .txt)
  </Step>

  <Step title="Install">
    Click "Upload & Install Certificate"
  </Step>
</Steps>

## Status Types

<CardGroup cols={3}>
  <Card title="Active" icon="check">
    Certificate installed and working
  </Card>

  <Card title="Installing" icon="clock">
    Installation in progress
  </Card>

  <Card title="Failed" icon="alert">
    Installation encountered error
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="DNS Issues">
    Ensure domain points to server IP
  </Accordion>

  <Accordion title="Load Balancer">
    Connect at least one server first
  </Accordion>

  <Accordion title="Cloudflare">
    Disable proxying for SSL installation
  </Accordion>

  <Accordion title="Failed Install">
    Check event logs for detailed errors
  </Accordion>
</AccordionGroup>