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

# Quickstart Guide

> Get started with RepoCloud in just a few minutes

## Get Started with RepoCloud

This quickstart guide will walk you through the process of deploying your first application on RepoCloud.

### Create Your Account

<Steps>
  <Step title="Sign Up">
    Visit [RepoCloud.io](https://repocloud.io/register) and create your account. New customers receive free credit for their first 30 days to get started.
  </Step>

  <Step title="Verify Your Email">
    Check your inbox for a verification email from RepoCloud and click the verification link.
  </Step>

  <Step title="Log In">
    Return to [RepoCloud.io](https://repocloud.io/login) and log in with your credentials.
  </Step>

  <Step title="Secure Your Account (Optional)">
    In the **Settings** tab of your dashboard, you can enable two-factor authentication (2FA) using any TOTP app such as Google Authenticator, Authy, Microsoft Authenticator, 1Password, or Bitwarden.
  </Step>
</Steps>

### Deploy Your First Application

<Steps>
  <Step title="Browse the Marketplace">
    Explore our [marketplace](https://repocloud.io/results) of over 270 applications to find the one you want to deploy.
  </Step>

  <Step title="Select an Application">
    Click on an application to view its details, features, and links to the developer's website and documentation, then click "Deploy Now".
  </Step>

  <Step title="Configure Settings">
    Enter a project name, then either keep the "Autoscale compute and storage resources" toggle enabled (the default) or disable it to pick a fixed server size. Some applications also ask for application-specific settings such as an admin username and password.

    <Note>
      Our platform automatically configures the optimal settings for each application, but you can customize them according to your needs.
    </Note>
  </Step>

  <Step title="Launch Your Application">
    Click the "Deploy App" button to launch your application. The deployment process typically takes 3-7 minutes.
  </Step>
</Steps>

### Manage Your Deployment

Once your application is deployed, you can manage it through our intuitive dashboard:

<AccordionGroup>
  <Accordion icon="globe" title="Set Up a Custom Domain">
    You can easily add your own domain to your deployment:

    1. Go to your application's management page
    2. Click "Add Custom Domain"
    3. Enter your domain name
    4. Add the two CNAME records shown (one for your subdomain, one for the `_acme-challenge` verification record) at your domain registrar
    5. Click "Confirm and Check Status" once the records are in place (DNS propagation can take up to 24-48 hours, but is often much faster)
  </Accordion>

  <Accordion icon="sliders" title="Monitor and Adjust Resources">
    Instances deployed with autoscaling (the default) adjust their resources automatically:

    1. Go to your application's management page
    2. Click "View Usage Chart" to see which resource tier your application has been using hour by hour

    If you deployed with a fixed server size, you can manually change it to a different tier—or switch it over to autoscaling—from the management page. (Autoscaled instances can't be switched back to a fixed size.)
  </Accordion>

  <Accordion icon="arrows-rotate" title="Update Your Application">
    Keep your application up-to-date with the latest version:

    1. Go to your application's management page
    2. Click the "Rebuild / Update" button
    3. Confirm the update

    Your application will be updated to the latest stable version while preserving your data.
  </Accordion>

  <Accordion icon="gear" title="Manage Environment Variables">
    Customize your application's configuration:

    1. Go to your application's management page
    2. Click "Edit Env Vars"
    3. Add, edit, or remove environment variables
    4. Click "Save Changes" and confirm

    Your application will restart with the new configuration; the restart typically takes 3-7 minutes.
  </Accordion>
</AccordionGroup>

## Next Steps

Now that you've deployed your first application, explore these resources to make the most of RepoCloud:

<CardGroup>
  <Card title="Platform Overview" icon="server" href="/platform/how-it-works">
    Learn more about how RepoCloud works behind the scenes
  </Card>

  <Card title="Supported Applications" icon="box-archive" href="https://repocloud.io/results">
    Browse our catalog of 270+ applications available for deployment
  </Card>

  <Card title="Deployment Guide" icon="rocket" href="/user-guide/deployment-basics">
    Discover advanced deployment options and best practices
  </Card>

  <Card title="Instance Management" icon="sliders" href="/user-guide/managing-instances">
    Master the tools for managing your deployed applications
  </Card>

  <Card title="Pricing & Billing" icon="credit-card" href="/pricing/overview">
    Understand how our pricing works to optimize your costs
  </Card>
</CardGroup>