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

# Deployment Basics

> Learn the fundamentals of deploying applications on RepoCloud

## Understanding RepoCloud Deployments

Deploying applications on RepoCloud is designed to be straightforward and user-friendly. This guide will walk you through the core concepts and steps for successful deployments.

## Deployment Lifecycle

<Steps>
  <Step title="Select an Application">
    Browse our marketplace to find the application you want to deploy. We offer over 270 pre-configured applications across different categories.
  </Step>

  <Step title="Configure Resources">
    Keep the "Autoscale compute and storage resources" toggle enabled (the default) to let RepoCloud optimize resource allocation automatically, or disable it to select a fixed server size. You can also add extra SSD storage at this step.
  </Step>

  <Step title="Application-Specific Settings">
    Configure settings specific to your chosen application, such as admin username and password, or other customization options.
  </Step>

  <Step title="Deploy">
    Click the "Deploy App" button to initiate the deployment process. RepoCloud will provision the necessary resources, set up your application container, and configure the networking.
  </Step>

  <Step title="Access and Configure">
    Once deployment is complete, you'll receive a URL on one of our hosting domains (in the format `https://<your-app-id>.<hosting-domain>`) to access your application. Most applications will have a setup wizard or admin interface for further configuration.
  </Step>
</Steps>

## Key Deployment Concepts

### Resource Tiers

RepoCloud offers several resource tiers to accommodate different needs:

| Tier | RAM      | vCPU | Storage    | Best For                                            |
| ---- | -------- | ---- | ---------- | --------------------------------------------------- |
| 1    | 1 GB     | 1    | 20 GB      | Small blogs, simple tools, development environments |
| 2    | 2 GB     | 1    | 30 GB      | Personal websites, small team collaboration         |
| 3    | 2 GB     | 2    | 40 GB      | Production websites, small business applications    |
| 4    | 4 GB     | 2    | 40 GB      | Medium traffic sites, larger databases              |
| 5    | 8 GB     | 4    | 80 GB      | High-traffic websites, data-intensive applications  |
| 6+   | 16-32 GB | 8-16 | 160-320 GB | Enterprise applications, large databases            |

### Autoscaling vs. Fixed Resources

<CardGroup cols={2}>
  <Card title="Autoscaling" icon="chart-line">
    **Benefits:**

    * Pay only for resources you actually use
    * Automatically handles traffic spikes
    * Scales down during low-activity periods
    * Cost-efficient for variable workloads
  </Card>

  <Card title="Fixed Resources" icon="lock">
    **Benefits:**

    * Predictable monthly costs
    * Guaranteed resources at all times
    * Simpler to budget and plan
    * Better for consistent workloads
  </Card>
</CardGroup>

<Note>
  Autoscaling monitors your application's resource usage and adjusts resources in real-time, charging on an hourly basis for what you actually use.
</Note>

## Application Persistence

Applications deployed on RepoCloud maintain data persistence across restarts and updates:

* **Persistent Storage**: Application data is stored on reliable NVMe SSD storage
* **Database Persistence**: Databases maintain data integrity across updates
* **Configuration Persistence**: Your application settings remain intact when updating or scaling

## Security Considerations

Every deployment on RepoCloud includes:

* **SSL Certificates**: Automatic SSL for secure HTTPS connections
* **Application Isolation**: Containerized deployments for security isolation
* **Regular Updates**: Latest security patches and application updates
* **Secure Networking**: Protected networking environment

## Common Deployment Questions

<AccordionGroup>
  <Accordion title="How long does deployment take?">
    Most applications deploy within 3-7 minutes. Larger applications with more complex setups might take longer.
  </Accordion>

  <Accordion title="Can I migrate my existing application?">
    Yes, most applications have built-in migration tools. For example, WordPress sites can be migrated using plugins, and databases can be imported through application-specific tools.
  </Accordion>

  <Accordion title="What happens if I need more resources?">
    If you deployed with autoscaling (the default), resources adjust automatically as demand changes—no action needed. If you deployed with a fixed server size, you can manually scale it to a different tier, or switch it over to autoscaling, from the management page. Note that autoscaled instances can't be switched back to a fixed size.
  </Accordion>

  <Accordion title="Can I use my own domain name?">
    Yes, you can connect your custom domain to any deployment with the "Add Custom Domain" button in the management dashboard.
  </Accordion>

  <Accordion title="How are applications updated?">
    RepoCloud maintains the latest stable versions of all applications. You can update your instance by clicking the "Rebuild / Update" button in the management dashboard.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup>
  <Card title="One-Click Deployment" icon="rocket" href="/user-guide/one-click-deployment">
    Learn about our one-click deployment process
  </Card>

  <Card title="Managing Instances" icon="sliders" href="/user-guide/managing-instances">
    Discover how to manage your deployed applications
  </Card>

  <Card title="Custom Domains" icon="globe" href="/user-guide/custom-domains">
    Set up custom domains for your applications
  </Card>

  <Card title="Environment Variables" icon="gear" href="/user-guide/environment-variables">
    Configure your applications with environment variables
  </Card>
</CardGroup>
