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

# Settings

> Manage general server configuration, settings, and server lifecycle in Loupp

## Overview

Server settings provide control over your server's configuration, including server details, SSH key management, and server lifecycle operations.

## Server Information

### Basic Server Details

The server settings interface displays server information:

<CardGroup cols={2}>
  <Card title="Network Configuration" icon="globe">
    * **Region**: Geographic location of the server
    * **Public IP**: Internet-facing IP address
  </Card>

  <Card title="Server Identity" icon="server">
    * **Server Name**: Human-readable server identifier
  </Card>
</CardGroup>

## Server Configuration

### Updating Server Details

<Steps>
  <Step title="Access server settings">
    Navigate to your server dashboard and click on the "Settings" tab.
  </Step>

  <Step title="Modify server information">
    Update the following fields as needed:

    * **Name**: Change the display name
    * **Port**: Modify the SSH connection port
    * **Server IP**: Update if IP address changes
  </Step>

  <Step title="Save changes">
    Click "Save" to apply the configuration changes.
  </Step>
</Steps>

<Info>
  Server name changes are immediately reflected in the dashboard and all related interfaces.
</Info>

### SSH Port Configuration

Customize the SSH connection port for enhanced security:

<AccordionGroup>
  <Accordion title="Default Port">
    Standard SSH port 22 is configured by default.
  </Accordion>

  <Accordion title="Custom Ports">
    Change to any available port (1024-65535) for security through obscurity.
  </Accordion>
</AccordionGroup>

<Warning>
  Changing SSH ports requires updating your SSH client configuration and firewall rules.
</Warning>

## Server SSH Key Management

### Server's SSH Key

Each server has a unique SSH key for integrations:

<AccordionGroup>
  <Accordion title="Key Generation">
    Loupp automatically generates a unique SSH key pair for each server.
  </Accordion>

  <Accordion title="Key Usage">
    Used for server integrations, deployments, and secure communications.
  </Accordion>
</AccordionGroup>

### Loupp SSH Key

The SSH key added to your server during setup:

<AccordionGroup>
  <Accordion title="Key Location">
    Stored in `/home/loupp/.ssh/authorized_keys` and `/root/.ssh/authorized_keys`
  </Accordion>

  <Accordion title="Key Restoration">
    If accidentally deleted, copy from settings and add back to server.
  </Accordion>
</AccordionGroup>

### Copying SSH Keys

<Steps>
  <Step title="Locate SSH key">
    Find the SSH public key in the server settings interface.
  </Step>

  <Step title="Copy key content">
    Click the copy button to copy the key content.
  </Step>

  <Step title="Use key">
    Add the key to services requiring server access (GitHub, GitLab, etc.).
  </Step>
</Steps>

<Tip>
  The server SSH key is essential for source control integrations and automated deployments.
</Tip>

## Server Lifecycle Management

### Server Archiving

Archive servers to temporarily disable them:

<Steps>
  <Step title="Access archive option">
    In the server settings, locate the "Archive Server" section.
  </Step>

  <Step title="Confirm archiving">
    Click "Archive" and confirm the action.
  </Step>

  <Step title="Server status change">
    The server status changes to "Archived" and becomes inactive.
  </Step>
</Steps>

<Info>
  Archived servers are not deleted and can be reconnected and reactivated at any time.
</Info>

### Server Destruction

Permanently remove servers:

<Steps>
  <Step title="Access destruction option">
    In server settings, locate the "Destroy Server" section.
  </Step>

  <Step title="Confirm destruction">
    Click "Destroy" and confirm the irreversible action.
  </Step>

  <Step title="Destruction process">
    The server status changes to "Deleting" and removal begins.
  </Step>
</Steps>

**Destruction Considerations:**

* **Data Loss**: All server data is permanently removed
* **Service Impact**: Applications and services are stopped
* **Billing**: Server billing stops immediately
* **Dependencies**: Check for dependent services or load balancers

<Warning>
  Server destruction is irreversible. Ensure you have backups of important data before proceeding.
</Warning>

<Warning>
  Servers connected to load balancers cannot be destroyed. Remove the load balancer connection first.
</Warning>

## Server Status Management

### Status Monitoring

Monitor server health and status:

<AccordionGroup>
  <Accordion title="Active Status">
    Server is running normally and accessible.
  </Accordion>

  <Accordion title="Archived Status">
    Server is temporarily disabled in loupp but data is preserved.
  </Accordion>

  <Accordion title="Building Status">
    Server is being provisioned or configured.
  </Accordion>

  <Accordion title="Deleting Status">
    Server is being removed from the system.
  </Accordion>

  <Accordion title="Error Status">
    Server encountered an issue requiring attention.
  </Accordion>
</AccordionGroup>