Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

docker

package

Go to main page

Versions in this module

v2

v2.5.0-rc.0

Jun 24, 2026

v2.4.0

Jun 24, 2026

v2.4.0-rc.0

May 27, 2026

v2.3.3

Jun 22, 2026

v2.3.2

Jun 9, 2026

Changes in this version

+ type ContainerExitError struct

+ ExitCode int

+ Stderr []byte

+ func (e *ContainerExitError) Error() string

v2.3.1

May 25, 2026

Changes in this version

+ func Check(ctx context.Context) error

+ func CopyFromContainer(ctx context.Context, cid, basePath string, fs afero.Fs) error

+ func GetContainerByName(ctx context.Context, name string, includeStopped bool) (*container.Summary, bool, error)

+ func GetContainerIDByName(ctx context.Context, name string, includeStopped bool) (string, bool, error)

+ func GetNetworkIDByName(ctx context.Context, name string) (string, bool, error)

+ func NewClient() (*client.Client, error)

+ func RunContainer(ctx context.Context, img string, opts ...RunContainerOption) ([]byte, []byte, error)

+ func StartContainer(ctx context.Context, name, img string, opts ...StartContainerOption) (string, error)

+ func StartContainerByID(ctx context.Context, id string) error

+ func StopContainerByID(ctx context.Context, cid string) error

+ func TarFromContainer(ctx context.Context, cid, path string) ([]byte, error)

+ func WaitForContainerByID(ctx context.Context, cid string) error

+ type RunContainerOption func(*runContainerConfig)

+ func RunWithBindMount(hostPath, containerPath string) RunContainerOption

+ func RunWithCommand(cmd []string) RunContainerOption

+ func RunWithExtraHosts(hosts []string) RunContainerOption

+ func RunWithNetworkName(name string) RunContainerOption

+ func RunWithStdin(data []byte) RunContainerOption

+ type StartContainerOption func(*startContainerConfig)

+ func StartWithBindMount(hostPath, containerPath string) StartContainerOption

+ func StartWithCommand(cmd []string) StartContainerOption

+ func StartWithCopyFiles(tarball []byte, path string) StartContainerOption

+ func StartWithEnv(env ...string) StartContainerOption

+ func StartWithNetworkID(nid string) StartContainerOption

+ func StartWithWorkingDirectory(path string) StartContainerOption

v2.3.0

May 21, 2026