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

# Astro CLI release notes archive: 1.19 through 1.10

> Archived Astro CLI release notes for versions 1.19 through 1.10.

Archived release notes for Astro CLI versions 1.19 through 1.10.

* [Current Astro CLI release notes](/docs/cli/release-notes)
* [Release notes: 1.37 through 1.20](/docs/cli/release-notes-archive-1)
* [Release notes: 1.9 through 0.2](/docs/cli/release-notes-archive-3)

<Update label="Astro CLI 1.19.4" description="November 1, 2023" rss={{ date: "2023-11-01" }}>
  ### Additional improvements

  * The Astro CLI now shows a warning if you attempt to deploy a project with an empty `dags` folder to Astro. To remove this warning along with all other CLI warnings, run `astro config set show_warnings false`.

  ### Bug fixes

  * Fixed an issue where `astro deployment create` sometimes showed an invalid Runtime version error for valid Runtime versions.
</Update>

<Update label="Astro CLI 1.19.3" description="October 12, 2023" rss={{ date: "2023-10-12" }}>
  ### Additional improvements

  * Sample test `test/dags/test_dag_integrity.py` was renamed to `test/dags/test_dag_example.py` to highlight that this test is an example.

  ### Bug fixes

  * Fixed an issue where CI/CD pipelines were unable to use Deployments as Code to create Deployment Previews for Deployments using the Kubernetes executor.
  * Fixed an issue where the CLI was asking users to select from the wrong regions when creating a Deployment on an AWS cluster.
  * Fixed an issue where secret variables values were being printed to local logs.
</Update>

<Update label="Astro CLI 1.19.2" description="September 14, 2023" rss={{ date: "2023-09-14" }}>
  ### Additional improvements

  * When you run `astro dev upgrade-test`, the generated HTML report for dag tests now shows how many dags passed and failed the test.

  ### Bug fixes

  * Fixed an issue where you couldn't create a Deployment on a dedicated cluster using a Deployment file and API token.
  * Fixed an issue where the Deployment URL that appears after you run `astro deploy` was not formatted properly.
  * Fixed an issue where `astro dev upgrade-test` would occasionally output that it was testing an upgrade to the latest version of Astro Runtime, even if it wasn't.
  * Fixed an issue where `astro dev upgrade-test` didn't produce an HTML report for dag tests.
</Update>

<Update label="Astro CLI 1.19.1" description="August 30, 2023" rss={{ date: "2023-08-30" }}>
  ### Bug fixes

  * Fixed an issue where dags would fail to parse correctly when running `astro dev parse` or `astro deploy`, resulting in a command execution failure.
</Update>

<Update label="Astro CLI 1.19.0" description="August 29, 2023" rss={{ date: "2023-08-29" }}>
  ### Additional improvements

  * You can now grant Astro users the `WORKSPACE_AUTHOR` role.
  * You can now run an Astro project from the same directory an Apache Airflow project.
  * `astro deployment inspect` now shows you a Deployment's workload identity.

  ### Bug fixes

  * Fixed an issue where some dags could be missed during `astro deploy` when dag-only deploys are enabled.
  * Fixed an issue where `astro dev pytest` would incorrectly fail when testing an Astro project within a CI/CD process.
  * Fixed an issue where you couldn't update a Deployment on a standard cluster using a Deployment file.
</Update>

<Update label="Astro CLI 1.18.2" description="August 10, 2023" rss={{ date: "2023-08-10" }}>
  ### Bug fixes

  * Fixed an issue where running `astro deployment create` on Astro Hosted would create Deployments where dag-only deploys were turned off by default.
</Update>

<Update label="Astro CLI 1.18.1" description="August 4, 2023" rss={{ date: "2023-08-04" }}>
  ### Bug fixes

  * Fixed an issue where `astro run` didn't work properly.
</Update>

<Update label="Astro CLI 1.18.0" description="August 3, 2023" rss={{ date: "2023-08-03" }}>
  ### New command to test Astro projects before you upgrade

  You can use the new `astro dev upgrade-test` command to anticipate and address problems before upgrading to a newer version of Astro Runtime. The command runs several test which let you determine whether an upgrade will result in major dependency changes and import errors, allowing you to fix the problems before you upgrade. See [Test your Astro project locally](/docs/cli/v1.46/test-your-astro-project-locally) for more information.

  ### Additional improvements

  * You can now specify the `--description` flag with `astro deploy` to add a description for your deploy. You can use this description to let other users know why you made a deploy or what changes a deploy contains.
  * You can now specify the `--role` flag with `astro organization team create/update` to update a Team's Organization-level role.
  * You can now specify the `--execution-date` flag with `astro run` to trigger a dag run for a specific execution date.
  * You can now specify the `--verbose` flag with `astro run` to stream all logs to your terminal after the dag run triggers.

  ### Bug fixes

  * Fixed an issue where `astro deployment inspect` was showing the wrong value for a Deployment’s workload identity on Astro Hosted.
  * Fixed an issue were `astro dev restart` would occasionally not work.
</Update>

<Update label="Astro CLI 1.17.1" description="July 12, 2023" rss={{ date: "2023-07-12" }}>
  ### Bug fixes

  * Fixed an issue were some Astro Hosted Deployment updates triggered by the Astro CLI were not working.
</Update>

<Update label="Astro CLI 1.17.0" description="July 6, 2023" rss={{ date: "2023-07-06" }}>
  ### Manage Organization API tokens with the Astro CLI

  You can now manage [Organization API tokens](/docs/astro/organization-api-tokens) using the following CLI commands:

  * [`astro organization token create`](/docs/cli/v1.46/astro-organization-token-create)
  * [`astro organization token roles`](/docs/cli/v1.46/astro-organization-token-roles)
  * [`astro organization token list`](/docs/cli/v1.46/astro-organization-token-list)
  * [`astro organization token update`](/docs/cli/v1.46/astro-organization-token-update)
  * [`astro organization token rotate`](/docs/cli/v1.46/astro-organization-token-rotate)
  * [`astro organization token delete`](/docs/cli/v1.46/astro-organization-token-delete)

  ### Download resources from the Astronomer Registry to your Astro project

  You can now use the following commands to download resources from the Astronomer Registry:

  * `astro registry dag add`
  * `astro registry provider add`

  The Astro registry contains dags and provider packages that are ready to use out of the box. Use these commands to quickly add resources to an Astro project, which you can then run locally or on Astro.

  ### Additional improvements

  * You can now create Deployments on AWS standard clusters.
  * If you belong to only one Workspace, the Astro CLI now uses that Workspace by default for all commands.

  ### Bug fixes

  * Fixed an issue where the Astro CLI could not retrieve the health status of a Deployment.
  * Fixed an issue where you could not set `worker_concurrency` to 0 in a Deployment file.
</Update>

<Update label="Astro CLI 1.16.2" description="June 30, 2023" rss={{ date: "2023-06-30" }}>
  ### Bug fixes

  * Fixed an issue where the `isHighAvailability` and `CICDEnforcement` fields in Deployment files were not processed correctly.
</Update>

<Update label="Astro CLI 1.16.1" description="June 13, 2023" rss={{ date: "2023-06-13" }}>
  ### Manage Teams using the Astro CLI

  You can now manage [Astro Teams](/docs/astro/manage-teams) using the following CLI commands:

  * [`astro workspace team add`](/docs/cli/v1.46/astro-workspace-team-add)
  * [`astro workspace team list`](/docs/cli/v1.46/astro-workspace-team-list)
  * [`astro workspace team update`](/docs/cli/v1.46/astro-workspace-team-update)
  * [`astro workspace team remove`](/docs/cli/v1.46/astro-workspace-team-remove)
  * [`astro organization team create`](/docs/cli/v1.46/astro-organization-team-create)
  * [`astro organization team list`](/docs/cli/v1.46/astro-organization-team-list)
  * [`astro organization team update`](/docs/cli/v1.46/astro-organization-team-update)
  * [`astro organization team delete`](/docs/cli/v1.46/astro-organization-team-delete)
  * [`astro organization team user remove`](/docs/cli/v1.46/astro-organization-team-user)
  * [`astro organization team user add`](/docs/cli/v1.46/astro-organization-team-user)
  * [`astro organization team user list`](/docs/cli/v1.46/astro-organization-team-user)

  You can use these commands in automated workflows with [Workspace API tokens](/docs/astro/workspace-api-tokens) and [Organization API tokens](/docs/astro/organization-api-tokens).

  ### Manage Workspace API tokens with the Astro CLI

  You can now manage [Workspace API tokens](/docs/astro/workspace-api-tokens) using the following CLI commands:

  * [`astro workspace token create`](/docs/cli/v1.46/astro-workspace-token-create)
  * [`astro workspace token add`](/docs/cli/v1.46/astro-workspace-token-add)
  * [`astro workspace token list`](/docs/cli/v1.46/astro-workspace-token-list)
  * [`astro workspace token update`](/docs/cli/v1.46/astro-workspace-token-update)
  * [`astro workspace token rotate`](/docs/cli/v1.46/astro-workspace-token-rotate)
  * [`astro workspace token delete`](/docs/cli/v1.46/astro-workspace-token-delete)

  These commands can be used to manage API tokens as part of an automated workflow.

  ### Additional improvements

  * You can now specify the `--cluster-type "dedicated"` flag when using `astro deployment create` to create a Deployment on a dedicated cluster in Astro Hosted.
  * You can now retrieve a Deployment's Workload Identity when using `astro deployment inspect`.
  * You can now specify the `--enforce-cicd` flag with `astro deployment create` and `astro deployment update` to [enforce CI/CD](/docs/astro/deployment-details#enforce-ci/cd-deploys) on a given Deployment.
  * You can now [manage Deployments as code](/docs/astro/manage-deployments-as-code) on Astro Hosted.
</Update>

<Update label="Astro CLI 1.15.1" description="May 19, 2023" rss={{ date: "2023-05-19" }}>
  ### Bug fixes

  * Fixed an issue where you could not create a Deployment on a standard Hosted cluster.
</Update>

<Update label="Astro CLI 1.15.0" description="May 18, 2023" rss={{ date: "2023-05-18" }}>
  ### New commands to manage Airflow resources on Deployments

  Use the following new Astro CLI commands to manage your Airflow variables, pools, connections, on Astro Deployments. These commands are particularly useful for automating the creation of new Deployments based on old ones, as you can now transfer all Airflow resources from a source Deployment to a target Deployment:

  * [`astro deployment connection list`](/docs/cli/v1.46/astro-deployment-connection-list)
  * [`astro deployment connection create`](/docs/cli/v1.46/astro-deployment-connection-create)
  * [`astro deployment connection update`](/docs/cli/v1.46/astro-deployment-connection-update)
  * [`astro deployment connection copy`](/docs/cli/v1.46/astro-deployment-connection-copy)
  * [`astro deployment airflow-variable list`](/docs/cli/v1.46/astro-deployment-airflow-variable-list)
  * [`astro deployment airflow-variable create`](/docs/cli/v1.46/astro-deployment-airflow-variable-create)
  * [`astro deployment airflow-variable update`](/docs/cli/v1.46/astro-deployment-airflow-variable-update)
  * [`astro deployment airflow-variable copy`](/docs/cli/v1.46/astro-deployment-airflow-variable-copy)
  * [`astro deployment pool list`](/docs/cli/v1.46/astro-deployment-pool-list)
  * [`astro deployment pool create`](/docs/cli/v1.46/astro-deployment-pool-create)
  * [`astro deployment pool update`](/docs/cli/v1.46/astro-deployment-pool-update)
  * [`astro deployment pool copy`](/docs/cli/v1.46/astro-deployment-pool-copy)

  ### Additional improvements

  * You can now use the `--args` flag to specify pytest arguments to run with `astro dev pytest`. For example, you can run `astro dev pytest --args "-p pytest_cov"` to plugin the `pytest_cov` plugin with your pyests.
  * You can now use Organization API tokens to automate Astro CLI tokens. Specify the Organization API token using the environment variable `ASTRO_API_TOKEN` in the environment where you run the Astro CLI.
  * You can now create a custom Docker/Podman compose file for your Astro project with the command `astro dev object export --compose`. After you modify the file, you can use it to start your project with `astro dev start --compose-file <compose-file-location>`.
  * You can now set `postgres.repository` and `postgres.tag` with `astro config set`. You can use these configurations to customize the postgres database used in your local Airflow environments.
  * The Astro CLI now automatically trims quotation marks from the beginning and end of environment variables being pushed to Astro.
  * The command `astro user invite` has been deprecated.

  ### Bug fixes

  * Fixed an issue were `astro deployment variable create/update` was not producing error when it failed to create an environment variable.
  * Fixed an issue were Podman deploys were failing if the user didn't have the Docker CLI installed.
</Update>

<Update label="Astro CLI 1.14.1" description="April 20, 2023" rss={{ date: "2023-04-20" }}>
  ### Bug fixes

  * Fixed an issue where `astro workspace user list` didn't work when using a Workspace API token.
</Update>

<Update label="Astro CLI 1.14.0" description="April 19, 2023" rss={{ date: "2023-04-19" }}>
  ### New commands to manage Astro Workspaces

  You can now manage Astro Workspaces from the Astro CLI using the following new commands:

  * [`astro workspace create`](/docs/cli/v1.46/astro-workspace-create)
  * [`astro workspace update`](/docs/cli/v1.46/astro-workspace-update)
  * [`astro workspace delete`](/docs/cli/v1.46/astro-workspace-delete)

  To automate Workspace management, you can run these commands using a [Workspace API token](/docs/astro/workspace-api-tokens).
</Update>

<Update label="Astro CLI 1.13.2" description="April 11, 2023" rss={{ date: "2023-04-11" }}>
  ### Bug fixes

  * Fixed an issue where the CLI added the `dags` folder to `.dockerignore` whenever an image build was interrupted, resulting in dags not being deployed on the next image build.
</Update>

<Update label="Astro CLI 1.13.0" description="March 30, 2023" rss={{ date: "2023-03-30" }}>
  <Warning>The command `astro user invite` will be deprecated in Astro CLI v1.15.0. Any use of this command in your projects or automation needs to be updated to [`astro organization user invite`](/docs/cli/v1.46/astro-organization-user-invite) before Astro CLI v1.15.0 is released.</Warning>

  ### New flag `--clean-output` for Deployment commands

  You can now use the `-—clean-output` flag with the following commands to make sure that any output comes only from the command itself.

  * `astro deployment inspect`
  * `astro deployment create`
  * `astro deployment update`

  This is helpful for users automating actions with deployment files, like using the Deploy Action template with [Github Actions](/docs/astro/ci-cd-templates/template-overview).

  ### New environment variable `ASTRO_HOME`

  The new environment variable `ASTRO_HOME` allows you to change the directory where the Astro CLI stores its global config file. This can be useful in environments where the CLI doesn’t have access to the HOME directory.

  ### Additional improvements

  * The command `astro login` won’t ask for email input in the command line anymore. You can now provide your email address in the browser when you log in.
</Update>

<Update label="Astro CLI 1.12.1" description="March 22, 2023" rss={{ date: "2023-03-22" }}>
  ### Bug fixes

  * Fixed an issue where you couldn't authenticate to the Astro from the Astro CLI using single sign-on (SSO).
</Update>

<Update label="Astro CLI 1.12.0" description="March 22, 2023" rss={{ date: "2023-03-22" }}>
  ### Additional improvements

  * You can now expose your local Airflow webserver and postgres database to all networks you're connected to using the following command:

    ```sh wrap theme={null}
    astro config set airflow.expose_port true
    ```

  * When you trigger a dag deploy to Astro, the CLI now includes the name of the dag bundle version that it pushed. You can use this name to verify that your Deployment uses the correct version of your dags after a deploy.

  * If you add the environment variable `ASTRO_API_TOKEN=<workspace-api-token>` to your environment, the Astro CLI will use the specified Workspace API token to perform Workspace and Deployment actions without requiring you to log in.

  * You can now disable [`astro run`](/docs/cli/v1.46/astro-run) commands and exclude `astro-run-dag` from any images built by the CLI using the following command:

    ```sh wrap theme={null}
    astro config set disable_astro_run true
    ```

  * In new Astro projects, `requirements.txt` now includes a commented list of the pre-installed provider packages on Astro Runtime.

  ### Bug fixes

  * Fixed an issue where the default dag integrity test would sometimes generate an error for valid uses of `os.getenv(key,default)`.
  * Fixed bugs in the default Astro project dags.
</Update>

<Update label="Astro CLI 1.11.0" description="February 27, 2023" rss={{ date: "2023-02-27" }}>
  ### Support for Podman

  You can now configure the Astro CLI to run Airflow locally and deploy to Astro using [Podman](https://podman.io/). Podman is an alternative container engine to Docker that doesn't require root access and orchestrates containers without using a centralized daemon.

  To configure the Astro CLI to use Podman, see [Run the Astro CLI using Podman](/docs/cli/v1.46/use-podman).

  ### Bug fixes

  * Fixed an issue where you couldn't run Astro CLI commands with a Deployment API key if you logged out of your personal account using `astro logout`.
  * Fixed an issue where you couldn't set the minimum worker count for a worker queue to zero.
  * Fixed an issue where running `astro deploy` would not return an error when you specified a Deployment name that didn't exist.
  * Fixed an issue where you could not update a Deployment with a file using a Deployment API key.
</Update>

<Update label="Astro CLI 1.10.0" description="February 2, 2023" rss={{ date: "2023-02-02" }}>
  ### New commands to manage Astro users

  To help you manage users in your Organization, Astro CLI 1.10.0 includes the following new commands:

  * `astro organization user invite`: Invite a new user to your Astronomer Organization.
  * `astro organization user update`: Update a user's Organization role.
  * `astro organization user list`: List all users in your Organization.
  * `astro workspace user add`: Add a user to a Workspace.
  * `astro workspace user update`: Update a user's role in a Workspace.
  * `astro workspace user list`: List all users in a Workspace.
  * `astro workspace user remove`: Remove a user from a Workspace.

  <Info>`astro organization user invite` is identical to the existing `astro user invite` command. `astro user invite` will be deprecated in a future release.</Info>

  For more information, see the [`astro organization`](/docs/cli/v1.46/astro-organization-user-invite) and [`astro workspace`](/docs/cli/v1.46/astro-workspace-user-add) command references.
</Update>