fix: remove binaries from git, add release/dbbackup_* to .gitignore

Binaries should only be uploaded via 'gh release', never committed to git.

.gitignore

@@ -37,3 +37,6 @@ CRITICAL_BUGS_FIXED.md
 LEGAL_DOCUMENTATION.md
 LEGAL_*.md
 legal/
+
+# Release binaries (uploaded via gh release, not git)
+release/dbbackup_*

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to dbbackup will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.1.2] - 2026-01-27
+
+### Added
+- **`--socket` flag for MySQL/MariaDB** - Connect via Unix socket instead of TCP/IP
+  - Usage: `dbbackup backup single mydb --db-type mysql --socket /var/run/mysqld/mysqld.sock`
+  - Works for both backup and restore operations
+  - Supports socket auth (no password required with proper permissions)
+
+### Fixed
+- **Socket path as --host now works** - If `--host` starts with `/`, it's auto-detected as a socket path
+  - Example: `--host /var/run/mysqld/mysqld.sock` now works correctly instead of DNS lookup error
+  - Auto-converts to `--socket` internally
+
 ## [4.1.1] - 2026-01-25
 
 ### Added

QUICK.md

@@ -14,6 +14,9 @@ dbbackup backup single myapp
 # MySQL
 dbbackup backup single gitea --db-type mysql --host 127.0.0.1 --port 3306
 
+# MySQL/MariaDB with Unix socket
+dbbackup backup single myapp --db-type mysql --socket /var/run/mysqld/mysqld.sock
+
 # With compression level (0-9, default 6)
 dbbackup backup cluster --compression 9
 

cmd/root.go

@@ -3,6 +3,7 @@ package cmd
 import (
 	"context"
 	"fmt"
+	"strings"
 
 	"dbbackup/internal/config"
 	"dbbackup/internal/logger"
@@ -107,6 +108,12 @@ For help with specific commands, use: dbbackup [command] --help`,
 			}
 		}
 
+		// Auto-detect socket from --host path (if host starts with /)
+		if strings.HasPrefix(cfg.Host, "/") && cfg.Socket == "" {
+			cfg.Socket = cfg.Host
+			cfg.Host = "localhost" // Reset host for socket connections
+		}
+
 		return cfg.SetDatabaseType(cfg.DatabaseType)
 	},
 }
@@ -136,6 +143,7 @@ func Execute(ctx context.Context, config *config.Config, logger logger.Logger) e
 	// Add persistent flags
 	rootCmd.PersistentFlags().StringVar(&cfg.Host, "host", cfg.Host, "Database host")
 	rootCmd.PersistentFlags().IntVar(&cfg.Port, "port", cfg.Port, "Database port")
+	rootCmd.PersistentFlags().StringVar(&cfg.Socket, "socket", cfg.Socket, "Unix socket path for MySQL/MariaDB (e.g., /var/run/mysqld/mysqld.sock)")
 	rootCmd.PersistentFlags().StringVar(&cfg.User, "user", cfg.User, "Database user")
 	rootCmd.PersistentFlags().StringVar(&cfg.Database, "database", cfg.Database, "Database name")
 	rootCmd.PersistentFlags().StringVar(&cfg.Password, "password", cfg.Password, "Database password")

internal/config/config.go

@@ -23,6 +23,7 @@ type Config struct {
 	User         string
 	Database     string
 	Password     string
+	Socket       string // Unix socket path for MySQL/MariaDB
 	DatabaseType string // "postgres" or "mysql"
 	SSLMode      string
 	Insecure     bool

internal/database/mysql.go

@@ -278,8 +278,12 @@ func (m *MySQL) GetTableRowCount(ctx context.Context, database, table string) (i
 func (m *MySQL) BuildBackupCommand(database, outputFile string, options BackupOptions) []string {
 	cmd := []string{"mysqldump"}
 
-	// Connection parameters - handle localhost vs remote differently
-	if m.cfg.Host == "" || m.cfg.Host == "localhost" {
+	// Connection parameters - socket takes priority, then localhost vs remote
+	if m.cfg.Socket != "" {
+		// Explicit socket path provided
+		cmd = append(cmd, "-S", m.cfg.Socket)
+		cmd = append(cmd, "-u", m.cfg.User)
+	} else if m.cfg.Host == "" || m.cfg.Host == "localhost" {
 		// For localhost, use socket connection (don't specify host/port)
 		cmd = append(cmd, "-u", m.cfg.User)
 	} else {
@@ -338,8 +342,12 @@ func (m *MySQL) BuildBackupCommand(database, outputFile string, options BackupOp
 func (m *MySQL) BuildRestoreCommand(database, inputFile string, options RestoreOptions) []string {
 	cmd := []string{"mysql"}
 
-	// Connection parameters - handle localhost vs remote differently
-	if m.cfg.Host == "" || m.cfg.Host == "localhost" {
+	// Connection parameters - socket takes priority, then localhost vs remote
+	if m.cfg.Socket != "" {
+		// Explicit socket path provided
+		cmd = append(cmd, "-S", m.cfg.Socket)
+		cmd = append(cmd, "-u", m.cfg.User)
+	} else if m.cfg.Host == "" || m.cfg.Host == "localhost" {
 		// For localhost, use socket connection (don't specify host/port)
 		cmd = append(cmd, "-u", m.cfg.User)
 	} else {
@@ -417,8 +425,11 @@ func (m *MySQL) buildDSN() string {
 
 	dsn += "@"
 
-	// Handle localhost with Unix socket vs TCP/IP
-	if m.cfg.Host == "" || m.cfg.Host == "localhost" {
+	// Explicit socket takes priority
+	if m.cfg.Socket != "" {
+		dsn += "unix(" + m.cfg.Socket + ")"
+	} else if m.cfg.Host == "" || m.cfg.Host == "localhost" {
+		// Handle localhost with Unix socket vs TCP/IP
 		// Try common socket paths for localhost connections
 		socketPaths := []string{
 			"/run/mysqld/mysqld.sock",

internal/engine/mysqldump.go

@@ -345,8 +345,10 @@ func (e *MySQLDumpEngine) Restore(ctx context.Context, opts *RestoreOptions) err
 	// Build mysql command
 	args := []string{}
 
-	// Connection parameters
-	if e.config.Host != "" && e.config.Host != "localhost" {
+	// Connection parameters - socket takes priority over host
+	if e.config.Socket != "" {
+		args = append(args, "-S", e.config.Socket)
+	} else if e.config.Host != "" && e.config.Host != "localhost" {
 		args = append(args, "-h", e.config.Host)
 		args = append(args, "-P", strconv.Itoa(e.config.Port))
 	}
@@ -494,8 +496,10 @@ func (e *MySQLDumpEngine) BackupToWriter(ctx context.Context, w io.Writer, opts
 func (e *MySQLDumpEngine) buildArgs(database string) []string {
 	args := []string{}
 
-	// Connection parameters
-	if e.config.Host != "" && e.config.Host != "localhost" {
+	// Connection parameters - socket takes priority over host
+	if e.config.Socket != "" {
+		args = append(args, "-S", e.config.Socket)
+	} else if e.config.Host != "" && e.config.Host != "localhost" {
 		args = append(args, "-h", e.config.Host)
 		args = append(args, "-P", strconv.Itoa(e.config.Port))
 	}

main.go

@@ -16,7 +16,7 @@ import (
 
 // Build information (set by ldflags)
 var (
-	version   = "4.1.1"
+	version   = "4.1.2"
 	buildTime = "unknown"
 	gitCommit = "unknown"
 )