# ComposeFile.AddVolume

- Module: [Aspire.Hosting.Docker](/reference/api/go/aspire.hosting.docker.md)
- Defined on: [ComposeFile](/reference/api/go/aspire.hosting.docker/composefile.md)
- Version: `17.0.0`
- Kind: `method`

Adds a top-level volume definition to the Docker Compose file.

## Definition

```go
type ComposeFile interface {
    // ... omitted for brevity
    AddVolume(
        name string,
        options ...*AddVolumeOptions,
    ) ComposeFile
}
```

## Signature

```go
AddVolume(
    name string,
    options ...*AddVolumeOptions,
) ComposeFile
```

## Parameters

- `name` (`string`) -- The name of the volume.
- `options` (`...*AddVolumeOptions`) -- optional settings, see [Options](#options)

## Options

Optional parameters are passed in a trailing `options ...*AddVolumeOptions` argument.

- `Driver` (`*string`) -- The volume driver to use.
- `External` (`*bool`) -- A value indicating whether the volume is managed outside the generated Compose file.
- `Configure` (`func(obj Volume)`) `callback` -- An optional callback for further volume customization.

## Returns

[`ComposeFile`](/reference/api/go/aspire.hosting.docker/composefile.md) -- The updated Docker Compose file.

Returns a handle; failures surface later via `Err()`.

## Defined on

- [ComposeFile](/reference/api/go/aspire.hosting.docker/composefile.md) -- `handle`
