Update settings for your Astro Organization
An Organization is the highest management level on Astro. In addition to configuring infrastructure for your Organization, you can update Organization settings that apply to all clusters, Workspaces, Deployments, and users within the Workspace.
This document includes instructions to configure high-level Organization settings from the Astro UI. To configure more specific Organization-level infrastructure, see:
- Manage users in an Astro Organization
- Set up authentication and single sign-on for Astro
- Create a dedicated Astro cluster
- Create and manage Organization API tokens
Prerequisites
- Organization Owner permissions
A new Astro UI is here
Astronomer has redesigned the Astro UI. Try the new experience and switch your instructions using the New Astro UI and Legacy UI tabs on this page. Your selection is remembered across the docs.
Update your Organization name
Your Organization name is a human-readable name that appears in the Astro UI and in the Astro CLI. Updating your Organization name is a cosmetic change that has no affect on any unique Organization information, such as your Organization ID, which persists for the lifetime of the Organization.
New Astro UI
Legacy UI
- In the Astro UI, go to Settings.
- In the Organization Name row, click the Edit pencil.
- Enter the new Organization name.
- Click Save.
Configure environment secrets fetching for the Astro Environment Manager
When members of your Organization create a local Airflow environment using the Astro CLI, they can pull connections configured in the Astro Environment Manager based on their Workspace credentials. This enables users to share connection details between Astro and their local Airflow environments and avoid creating connections twice. See Import and export Airflow connections and variables for more details.
You can enable or disable this feature based on whether you want Organization members to access Astro-configured connection details from their local machines.
New Astro UI
Legacy UI
- In the Astro UI, go to Settings.
- Scroll to the Organization Policies section.
- Click the Environment Secrets Showable toggle to enable or disable the feature.
Enforce dedicated clusters for new Deployments
Organization Owners can restrict new Deployments to dedicated clusters only. When you enable Enforce Dedicated Clusters, Astro rejects requests to create new Deployments on standard clusters, both in the Astro UI and through the Astro API. Existing Deployments on standard clusters continue to run without changes.
This setting is available to eligible Organizations.
New Astro UI
Legacy UI
- In the Astro UI, go to Settings.
- Scroll to the Organization Policies section.
- Click the Enforce Dedicated Clusters toggle to enable or disable it.
Configure security contacts
Security contacts are email addresses, other than Organization Owners, that receive security notifications for your Organization.
New Astro UI
Legacy UI
- In the Astro UI, go to Settings, then scroll to the Security section.
- Next to Security Contacts, click the Edit pencil.
- To add an address, click + Add Email and enter a valid email. To remove an address, click the trash can next to it.
- Click Update Security Contacts.