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

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

![List of all environments as a tree](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/environments.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=01ef261cad3d13b4ce8f2dd53e147f1a)

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](https://developer.upsun.com/docs/observability/metrics), and [backups](https://developer.upsun.com/docs/environments/backup.md).

## Activity Feed

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

![Environment activity list](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/activity.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=1dceac720590adb2e0d25fdc68c8d9d4)

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:

* [ **Branch**](https://developer.upsun.com/docs/glossary.md#branch) to create a new child environment.
* [ **Merge**](https://developer.upsun.com/docs/glossary.md#merge) to copy the current environment into its parent.
* [ **Sync**](https://developer.upsun.com/docs/glossary.md#sync)
  to copy changes from its parent environment into the current environment.

There are also additional options:

*  **Settings** to [configure the environment](#environment-settings).
*  **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 Cloud CLI](https://developer.upsun.com/cli.md).
  * **Git** for the command to clone the codebase via Git.

    If you're using Upsun Cloud as your primary remote repository, the command clones from the project.
    If you have set up an [external integration](https://developer.upsun.com/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](https://developer.upsun.com/docs/integrations/source/troubleshoot.md).

## 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](https://developer.upsun.com/docs/environments.md#default-environment)'s information is loaded, follow these steps:

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

## Environment settings

To access the settings of an environment, click  **Settings** within that environment.

![Settings for an environment](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-settings.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=8d214394c4400184005b1f53882f5466)

### Environment name

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

![Environment status](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-name.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=67c6966ee3a9589cc0a4f9c870ab4d48)

### Status

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

![Environment status](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-status.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=626fb34e9aa96694655d7a1c7f9ccf9d)

For preview environments, you can [change their status](https://developer.upsun.com/docs/environments/deactivate-environment.md).

### Outgoing emails

Under **Outgoing emails**, you can allow your environment to [send emails](https://developer.upsun.com/docs/development/email.md):

![Environment email](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-email.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=fa5272c662c74fafbb67dabdd08c5b00)

### Hide from search engines

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

![Environment search](https://mintcdn.com/upsun-c9761871/7cK3KMJBgO7MXm_y/images/management-console/env-search.png?fit=max\&auto=format\&n=7cK3KMJBgO7MXm_y\&q=85\&s=fde3471ffc4ee249b9added276af8f86)

### HTTP access control

Under **HTTP access control**, you can [control access to your environment using HTTP methods](https://developer.upsun.com/docs/environments/http-access-control.md):

![Settings control access with password and by IP](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)

### Variables

Under **Variables**, you can define [environment variables](https://developer.upsun.com/docs/development/variables):

![Configure Upsun Cloud environment variables](https://mintcdn.com/upsun-c9761871/tdb1nLmHEPAmx6I9/images/management-console/settings-variables-environment.png?fit=max\&auto=format\&n=tdb1nLmHEPAmx6I9\&q=85\&s=86f1f6180dcb28935d971433edd57360)

## 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](https://developer.upsun.com/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:

![Services: app overview](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)

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](https://developer.upsun.com/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](https://developer.upsun.com/docs/configure-apps/), click **Configuration**.

### Services

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

![Services: service overview](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)

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](https://developer.upsun.com/docs/observability/metrics).

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.