# aspire start command

## Name

`aspire start` - Start an apphost in the background.

## Synopsis

```bash title="Aspire CLI"
aspire start [options] [[--] <additional arguments>...]
```

## Description

The `aspire start` command starts an AppHost in the background and exits after the apphost is running. Use it when you want a detached apphost that you can inspect later with commands such as `aspire ps`, `aspire describe`, `aspire logs`, and `aspire stop`.

<Include relativePath="reference/cli/includes/project-search-logic-description.md" />

You can output detached startup details as a table or JSON, and you can pass additional arguments through to the AppHost by using the `--` delimiter.

## Options

The following options are available:

- **`--`**

  Delimits arguments to `aspire start` from arguments for the AppHost being run. All arguments after this delimiter are passed to the application.

- **`--no-build`**

  Do not build or restore the project before running. Use this option when you have already built the project and want to skip the restore and build step.

- <Include relativePath="reference/cli/includes/option-project.md" />

- **`--format <Json|Table>`**

  Output format for detached apphost results. Use `Json` for machine-readable output suitable for scripting and automation.

- **`--isolated`**

  Run in isolated mode with randomized ports and isolated user secrets, allowing multiple instances of the same AppHost to run simultaneously.

- <Include relativePath="reference/cli/includes/option-help.md" />

- <Include relativePath="reference/cli/includes/option-log-level.md" />

- <Include relativePath="reference/cli/includes/option-non-interactive.md" />

- <Include relativePath="reference/cli/includes/option-nologo.md" />

- <Include relativePath="reference/cli/includes/option-banner.md" />

- <Include relativePath="reference/cli/includes/option-wait.md" />

## Examples

- Start the AppHost discovered from the current directory:

  ```bash title="Aspire CLI"
  aspire start
  ```

- Start a specific AppHost in the background:

  ```bash title="Aspire CLI"
  aspire start --apphost './src/MyApp.AppHost/MyApp.AppHost.csproj'
  ```

- Output detached startup details as JSON:

  ```bash title="Aspire CLI"
  aspire start --format Json
  ```

- Start the AppHost in isolated mode:

  ```bash title="Aspire CLI"
  aspire start --isolated
  ```

- Start the AppHost with a specific environment:

  ```bash title="Aspire CLI"
  aspire start --environment Development
  ```

## See also

- [aspire run](../aspire-run/)
- [aspire ps](../aspire-ps/)
- [aspire logs](../aspire-logs/)
- [aspire stop](../aspire-stop/)