Struct DockerClient 

pub struct DockerClient { /* private fields */ }

Docker client wrapper with connection handling

Implementations

impl DockerClient

pub fn new() -> Result<Self, DockerError>

Create new client connecting to local Docker daemon

Uses platform-appropriate socket (Unix socket on Linux/macOS). Returns a clear error if Docker is not running or accessible.

pub fn with_timeout(timeout_secs: u64) -> Result<Self, DockerError>

Create client with custom timeout (in seconds)

Use for long-running operations like image builds. Default timeout is 120 seconds; build timeout should be 600+ seconds.

pub async fn connect_remote( host: &HostConfig, host_name: &str, ) -> Result<Self, DockerError>

Create client connecting to remote Docker daemon via SSH tunnel

Establishes an SSH tunnel to the remote host and connects Bollard to the forwarded local port.

Arguments

• host - Remote host configuration
• host_name - Name of the host (for display purposes)

pub async fn connect_remote_with_timeout( host: &HostConfig, host_name: &str, timeout_secs: u64, ) -> Result<Self, DockerError>

Create remote client with custom timeout

pub async fn verify_connection(&self) -> Result<(), DockerError>

Verify connection to Docker daemon

Returns Ok(()) if connected, descriptive error otherwise.

pub async fn version(&self) -> Result<String, DockerError>

Get Docker version info (useful for debugging)

pub fn host_name(&self) -> Option<&str>

Get the host name if this is a remote connection

pub fn is_remote(&self) -> bool

Check if this is a remote connection

pub fn inner(&self) -> &Docker

Access inner Bollard client for advanced operations