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

# Configure environments

> Configure your environments including their name, status, and visibility.

export const SyncIcon = () => <svg width="24px" height="24px" style={{
  display: 'inline',
  verticalAlign: 'middle'
}}>
    <title id="sync-icon">Sync</title>
    <path fill="current" className="fill-target" fillRule="evenodd" clipRule="evenodd" d="M12.1,2.7L13.7,4l2,1.8c0.4,0.3,0.4,0.9,0,1.2l-2,1.6l-1.6,1.3c-0.5,0.4-1.1,0-1.1-0.6V7.2 c-2.8,0.5-5,2.9-5,5.9c0,2.7,1.8,5,4.3,5.8c0.5,0.1,0.8,0.6,0.7,1.1c-0.1,0.6-0.7,1-1.3,0.8C6.4,19.7,4,16.6,4,13.1 C4,9,7.1,5.7,11,5.2V3.3C11,2.6,11.6,2.3,12.1,2.7z M17.6,9c-0.4,0.3-0.5,0.8-0.3,1.3c0.2,0.4,0.4,0.8,0.5,1.2 c0.1,0.5,0.6,0.8,1.1,0.7c0.6-0.1,1-0.7,0.8-1.3c-0.1-0.2-0.2-0.5-0.3-0.8v0c-0.1-0.3-0.2-0.6-0.3-0.8C18.8,8.8,18.1,8.6,17.6,9z M17.2,16c-0.2,0.5-0.1,1,0.3,1.3c0.5,0.3,1.2,0.2,1.4-0.3c0.2-0.4,0.4-0.8,0.6-1.3c0-0.1,0.1-0.2,0.1-0.3c0.2-0.6-0.2-1.2-0.8-1.3 c-0.5-0.1-1,0.2-1.1,0.7C17.6,15.2,17.4,15.6,17.2,16z M13.7,18.9C13.2,19,12.9,19.5,13,20s0.7,0.9,1.3,0.8c0.5-0.1,1-0.3,1.5-0.6 c0.5-0.3,0.7-1,0.3-1.5c-0.3-0.4-0.9-0.5-1.3-0.3C14.5,18.6,14.1,18.8,13.7,18.9z"></path>
  </svg>;

export const SettingsIcon = () => <svg width="24px" height="24px" style={{
  display: 'inline',
  verticalAlign: 'middle'
}}>
    <title id="settings-icon">Settings</title>
    <path d="M10.5289 21.9416C9.86066 21.8582 9.3595 21.3576 9.19245 20.6903L9.02539 19.6892C8.85834 19.6058 8.77482 19.6058 8.60776 19.5224L7.93955 20.0229C7.43839 20.44 6.68665 20.44 6.10196 20.0229C6.10196 20.0229 4.09732 18.1042 4.01379 17.9374C3.51263 17.3535 3.51263 16.6027 3.93027 16.0187L4.51495 15.3514C4.43143 15.1845 4.43143 15.1011 4.3479 14.9343L3.42911 14.7674C2.76089 14.684 2.25973 14.1835 2.09268 13.4327C2.00915 13.1824 2.09268 10.4296 2.09268 10.4296C2.17621 9.76222 2.67737 9.2617 3.34558 9.09486L4.3479 8.92802C4.43143 8.8446 4.43143 8.76118 4.51495 8.59434L4.01379 7.92697C3.59616 7.42645 3.59616 6.67567 4.01379 6.09173C4.01379 6.09173 5.93491 4.08964 6.10196 4.00622C6.68665 3.5057 7.43839 3.5057 8.02307 3.9228L8.69129 4.50675C8.85834 4.42333 8.94187 4.42333 9.10892 4.33991L9.27597 3.42228C9.3595 2.75492 9.86066 2.2544 10.6124 2.08756C10.863 2.00414 13.2853 2.00414 13.5358 2.08756H13.6194C14.2876 2.17098 14.7887 2.6715 14.9558 3.33886L15.1228 4.33991C15.2064 4.42333 15.2899 4.50675 15.457 4.50675L16.1252 4.00622C16.6263 3.58912 17.3781 3.58912 17.9628 4.00622C17.9628 4.00622 19.9674 5.92489 20.0509 6.09173C20.5521 6.67567 20.5521 7.42645 20.1344 8.0104L19.6333 8.67776C19.7168 8.8446 19.7168 9.01144 19.8003 9.09486L20.7191 9.2617C21.3873 9.34512 21.972 9.92906 22.0556 10.5964V13.5996C21.972 14.2669 21.4709 14.7674 20.8027 14.9343L19.8003 15.1011C19.7168 15.268 19.7168 15.3514 19.6333 15.5182L20.218 16.269C20.6356 16.7695 20.6356 17.5203 20.218 18.1042L18.0463 20.2732C17.4616 20.6903 16.7099 20.6903 16.2087 20.2732L15.3734 19.6058C15.2064 19.6892 15.1228 19.6892 14.9558 19.7726L14.7887 20.6903C14.7052 21.3576 14.1205 21.9416 13.4523 22.025H10.5289V21.9416ZM11.5312 20.3566C11.8653 20.3566 12.1994 20.3566 12.45 20.3566C12.8676 20.3566 13.2017 20.0229 13.2853 19.6058L13.3688 18.9384C13.3688 18.6882 13.6194 18.4379 13.8699 18.2711L15.1228 17.7706C15.3734 17.6871 15.7075 17.6871 15.9581 17.854L16.5428 18.2711C16.8769 18.5213 17.3781 18.5213 17.6286 18.1877C17.7957 18.0208 18.0463 17.7706 18.2969 17.5203C18.5474 17.1866 18.631 16.7695 18.3804 16.4358L17.8792 16.0187C17.7122 15.7685 17.6286 15.4348 17.7957 15.1845L18.2969 14.0167C18.3804 13.7664 18.631 13.5996 18.9651 13.5161L19.6333 13.4327C20.0509 13.3493 20.385 13.0156 20.385 12.5985C20.385 12.2648 20.385 11.9311 20.385 11.6809C20.385 11.2638 20.0509 10.9301 19.6333 10.8467L18.9651 10.7633C18.7145 10.7633 18.4639 10.513 18.2969 10.2627L17.7957 9.01144C17.7122 8.76118 17.7122 8.4275 17.8792 8.17724L18.2969 7.59329C18.5474 7.25961 18.5474 6.84251 18.2133 6.50883C18.0463 6.34199 17.7957 6.09173 17.5451 5.84147C17.211 5.50779 16.7934 5.50779 16.4593 5.75805L16.0416 6.17515C15.7911 6.34199 15.457 6.42541 15.2064 6.25857L14.037 5.75805C13.7864 5.67463 13.6194 5.42437 13.5358 5.09069L13.3688 4.50675C13.2853 4.08964 12.9511 3.75596 12.5335 3.75596C12.1994 3.75596 11.8653 3.75596 11.6147 3.75596C11.1971 3.75596 10.863 4.08964 10.7795 4.50675L10.6959 5.17411C10.6959 5.42437 10.4453 5.67463 10.1948 5.84147L9.02539 6.25857C8.69129 6.42541 8.44071 6.34199 8.19013 6.17515L7.60544 5.75805C7.27133 5.50779 6.77017 5.50779 6.51959 5.84147C6.26901 6.00831 6.10196 6.25857 5.85138 6.42541C5.6008 6.75909 5.51727 7.17619 5.85138 7.50987L6.18549 8.09382C6.35254 8.34408 6.43607 8.67776 6.26901 8.92802L5.76785 10.0959C5.68433 10.3462 5.43375 10.513 5.09964 10.5964L4.43143 10.6798C4.01379 10.7633 3.67969 11.0969 3.67969 11.514C3.67969 11.8477 3.67969 12.1814 3.67969 12.4317C3.67969 12.8488 4.01379 13.1825 4.43143 13.2659L5.09964 13.3493C5.35022 13.3493 5.6008 13.5996 5.76785 13.8498L6.26901 15.1011C6.35254 15.3514 6.35254 15.6851 6.18549 15.9353L5.76785 16.5193C5.51727 16.8529 5.51727 17.3535 5.85138 17.6037C6.01843 17.7706 6.26901 18.0208 6.51959 18.2711C6.8537 18.5213 7.27133 18.6048 7.60544 18.3545L8.02307 17.854C8.27365 17.6871 8.60776 17.6037 8.85834 17.7706L10.0277 18.2711C10.2783 18.3545 10.4453 18.6048 10.5289 18.9384L10.6124 19.6058C10.7795 20.0229 11.1136 20.3566 11.5312 20.3566ZM18.798 6.92593C18.798 6.92593 18.798 7.00935 18.798 6.92593V6.92593Z"></path>
    <path d="M12.0324 17.0198C9.27597 17.0198 7.02075 14.7675 7.02075 12.0146C7.02075 9.26172 9.27597 7.00937 12.0324 7.00937C14.7887 7.00937 17.044 9.26172 17.044 12.0146C17.044 14.7675 14.7887 17.0198 12.0324 17.0198ZM12.0324 8.67777C10.1948 8.67777 8.69129 10.1793 8.69129 12.0146C8.69129 13.8498 10.1948 15.3514 12.0324 15.3514C13.8699 15.3514 15.3734 13.8498 15.3734 12.0146C15.3734 10.1793 13.8699 8.67777 12.0324 8.67777Z"></path>
  </svg>;

export const MoreIcon = () => <svg width="24px" height="24px" style={{
  display: 'inline',
  verticalAlign: 'middle'
}}>
    <title id="more-icon">More</title>
    <path d="M12 6.5C12.8284 6.5 13.5 5.82843 13.5 5C13.5 4.17157 12.8284 3.5 12 3.5C11.1716 3.5 10.5 4.17157 10.5 5C10.5 5.82843 11.1716 6.5 12 6.5Z" fill="current"></path>
    <path d="M12 13.5C12.8284 13.5 13.5 12.8284 13.5 12C13.5 11.1716 12.8284 10.5 12 10.5C11.1716 10.5 10.5 11.1716 10.5 12C10.5 12.8284 11.1716 13.5 12 13.5Z" fill="current"></path>
    <path d="M12 20.5C12.8284 20.5 13.5 19.8284 13.5 19C13.5 18.1716 12.8284 17.5 12 17.5C11.1716 17.5 10.5 18.1716 10.5 19C10.5 19.8284 11.1716 20.5 12 20.5Z" fill="current"></path>
  </svg>;

export const MergeIcon = () => <svg width="24px" height="24px" style={{
  display: 'inline',
  verticalAlign: 'middle'
}}>
    <title id="merge-icon">Merge</title>
    <g>
      <g transform="translate(-89.000000, -1127.000000)">
        <g transform="translate(50.000000, 920.000000)">
          <g transform="translate(34.000000, 204.000000)">
            <path fill="current" className="fill-target" d="M22.7,22.7L22.7,22.7c0.4-0.4,0.4-1,0-1.4l-2-2c-0.4-0.4-1-0.4-1.4,0l0,0c-0.4,0.4-0.4,1,0,1.4l2,2 C21.7,23.1,22.3,23.1,22.7,22.7z M13.7,11H16v4.8c0,0.5-0.2,1-0.6,1.4l-4.1,4.1c-0.4,0.4-0.4,1,0,1.4h0c0.4,0.4,1,0.4,1.4,0 l4.7-4.7c0.4-0.4,0.6-0.9,0.6-1.4V11h2.3c0.4,0,0.7-0.5,0.4-0.9l-3.3-3.3c-0.2-0.2-0.5-0.2-0.7,0l-3.3,3.3 C13,10.5,13.3,11,13.7,11z"></path>
          </g>
        </g>
      </g>
    </g>
  </svg>;

export const BranchIcon = () => <svg width="24px" height="24px" style={{
  display: 'inline',
  verticalAlign: 'middle'
}}>
    <title id="branch-icon">Branch</title>
    <path fill="current" className="fill-target" d="M14.5,4.9l1.6,1.6l-2.4,2.4c-0.4,0.4-0.4,1,0,1.4l0.1,0.1c0.4,0.4,1,0.4,1.4,0L17.6,8l1.6,1.6c0.3,0.3,0.9,0.1,0.9-0.4V4.5 c0-0.3-0.2-0.5-0.5-0.5h-4.7C14.4,4,14.2,4.5,14.5,4.9z M8.8,4H4.5C4.2,4,4,4.2,4,4.5v4.3c0,0.4,0.5,0.7,0.9,0.4l1.4-1.4l4.1,4.1 c0.4,0.4,0.6,0.9,0.6,1.4V19c0,0.6,0.4,1,1,1l0,0c0.6,0,1-0.4,1-1v-6.6c0-0.5-0.2-1-0.6-1.4L7.7,6.3l1.4-1.4C9.5,4.5,9.2,4,8.8,4z"></path>
  </svg>;

From your project's main page in the Console, you can see all your environments as a list or a project tree:

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/environments.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=01ef261cad3d13b4ce8f2dd53e147f1a" alt="List of all environments as a tree" width="1808" height="1420" data-path="images/management-console/environments.png" />

In this overview, the names of inactive environments are lighter.
Selecting an environment allows you to see details about it,
such as its [activity feed](#activity-feed), [services](#service-information),
[metrics](/docs/observability/metrics), and [backups](/docs/environments/backup).

## Activity Feed

When you access an environment in the Console, you can see its [activity feed](/docs/observability/logs/access-logs#activity-logs).
This allows you to check which activities have happened or are currently happening on the selected environment:

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/activity.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=1dceac720590adb2e0d25fdc68c8d9d4" alt="Environment activity list" width="1600" height="1200" data-path="images/management-console/activity.png" />

You can filter activities by type (such as merge, sync, or redeploy).

## Actions on environments

Each environment offers ways to keep environments up to date with one another:

* [<BranchIcon /> **Branch**](/docs/glossary#branch) to create a new child environment.
* [<MergeIcon /> **Merge**](/docs/glossary#merge) to copy the current environment into its parent.
* [<SyncIcon /> **Sync**](/docs/glossary#sync)
  to copy changes from its parent environment into the current environment.

There are also additional options:

* <SettingsIcon /> **Settings** to [configure the environment](#environment-settings).
* <MoreIcon /> **More** to get more options.
* **URLs** to access the deployed environment from the web.
* **SSH** to access your project using SSH.
* **Code**
  * **CLI** for the command to get your project set up locally with the [Upsun CLI](/cli).
  * **Git** for the command to clone the codebase via Git.

    If you're using Upsun as your primary remote repository, the command clones from the project.
    If you have set up an [external integration](/docs/integrations/source),
    the command clones directly from the integrated remote repository.

    If the project uses an external integration to a repository that you haven't been given access to,
    you can't clone until your access has been updated.
    See how to [troubleshoot source integrations](/docs/integrations/source/troubleshoot).

## Environment URL

When you access an environment in the Console, you can view its URL. While the environment is loading in the Console, a `Waiting for URL...` message is displayed instead of the URL. If this message isn't updated once your [default environment](/docs/environments#default-environment)'s information is loaded, follow these steps:

1. Check that [you have defined routes](/docs/routes) for your default environment.
2. Verify that your [application](/docs/configure-apps/app-reference/single-runtime-image), [services](/docs/add-services), and [routes](/docs/routes) configurations are correct.
3. Check that your default environment is [active](/docs/environments/deactivate-environment#reactivate-an-environment).

## Environment settings

To access the settings of an environment, click <SettingsIcon /> **Settings** within that environment.

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-settings.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=8d214394c4400184005b1f53882f5466" alt="Settings for an environment" width="2300" height="1260" data-path="images/management-console/env-settings.png" />

### Environment name

Under **Environment name**, you can edit the name and type of your environment and view its parent environment:

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-name.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=67c6966ee3a9589cc0a4f9c870ab4d48" alt="Environment status" width="1868" height="625" data-path="images/management-console/env-name.png" />

### Status

Under **Status**, you can check whether or not your environment is [active](/docs/glossary#active-environment).

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-status.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=626fb34e9aa96694655d7a1c7f9ccf9d" alt="Environment status" width="1081" height="634" data-path="images/management-console/env-status.png" />

For preview environments, you can [change their status](/docs/environments/deactivate-environment).

### Outgoing emails

Under **Outgoing emails**, you can allow your environment to [send emails](/docs/development/email):

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-email.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=fa5272c662c74fafbb67dabdd08c5b00" alt="Environment email" width="946" height="167" data-path="images/management-console/env-email.png" />

### Hide from search engines

Under **Hide from search engines**, you can tell [search engines to ignore the site](/docs/environments/search-engine-visibility):

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-search.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=fde3471ffc4ee249b9added276af8f86" alt="Environment search" width="1804" height="443" data-path="images/management-console/env-search.png" />

### HTTP access control

Under **HTTP access control**, you can [control access to your environment using HTTP methods](/docs/environments/http-access-control):

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/settings-basics-access-control.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=9397e4555375b2df1cbe40a17d7e5844" alt="Settings control access with password and by IP" width="1059" height="598" data-path="images/management-console/settings-basics-access-control.png" />

### Variables

Under **Variables**, you can define [environment variables](/docs/development/variables):

<img src="https://mintcdn.com/upsun-c9761871/tdb1nLmHEPAmx6I9/images/management-console/settings-variables-environment.png?fit=max&auto=format&n=tdb1nLmHEPAmx6I9&q=85&s=86f1f6180dcb28935d971433edd57360" alt="Configure Upsun environment variables" width="3438" height="1950" data-path="images/management-console/settings-variables-environment.png" />

## Service information

For each environment, you can view information about how your routes, services, and apps are currently configured.

To do so, click **Services**.
By default, you see configured routes.

### Routes

The **Router** section shows a list of all the [routes configured on your environment](/docs/routes).
You can see each route's type and check if caching and server side includes have been enabled for it.

To view the configuration file where your routes are set up, click **Configuration**.

### Applications

To see detailed information about an app container,
select it in the tree or list on the left-hand side:

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/service-tab/app-overview.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=ae31dd158e6b0a71e2e1acc03b95db8a" alt="Services: app overview" width="2886" height="1887" data-path="images/management-console/service-tab/app-overview.png" />

The **Overview** tab gives you information about your app.
You can see:

* The language version, the container size, the amount of persistent disk,
  the number of cron jobs, and the command to SSH into the container.
* A summary of [metrics for the environment](/docs/observability/metrics).
* All cron jobs with their name, frequency, and command.
* All workers with their name, size, amount of persistent disk, and command to SSH into the container.

To view [the configuration file where your app is set up](/docs/configure-apps/), click **Configuration**.

### Services

To see detailed information about a [running service](/docs/add-services),
select it in the tree or list on the left-hand side:

<img src="https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/service-tab/service-overview.png?fit=max&auto=format&n=7cK3KMJBgO7MXm_y&q=85&s=a80a1e6f23205def809b0ada7faaf6c0" alt="Services: service overview" width="2255" height="1096" data-path="images/management-console/service-tab/service-overview.png" />

The **Overview** gives you information about the selected service.
You can see the service version, the container size, and the disk size, if you've configured a persistent disk.
You can also see a summary of [metrics for the environment](/docs/observability/metrics).

To view the configuration file where your services are set up, click **Configuration**.
