Docker Tool Suite (dtools)

A Bash script with a Text User Interface (TUI) to simplify managing Docker Compose applications, backups, and updates on Linux servers.

📋 Features

• App Management: Start, stop, restart, and force recreate containers. Includes an update checker to only recreate changed images.
• Backups: Auto-detects and backs up volumes for specific apps or standalone volumes. Supports zstd compression and AES-256 encrypted 7-Zip archives using a secure local key.
• Automation: Built-in scheduler (Cron) for automatic compose apps updates and unused images.
• Maintenance: View logs, inspect image healthchecks, prune system, and manage local image history for rollbacks.
• Safety: Includes "Dry Run" modes and validates configuration inputs (paths, integers) to prevent errors.
• Experience: Native Bash and Zsh autocompletion for commands, Docker volumes, and file paths.

🏗️ Installation

1. Clone the repo:

   git clone https://github.com/Pavdig/dtools.git
   cd dtools
   

2. Make executable:

   chmod +x docker_tool_suite.sh

3. Run:

   ./docker_tool_suite.sh

   The script may ask you to install dependencies (openssl, 7zip) and guide you through the initial setup wizard.

   Tip: Restart your terminal (or run source ~/.bashrc / source ~/.zshrc) after the first run to enable autocompletion.

🛠️ Usage

Interactive Mode: Run with sudo to access the menu:

sudo ./docker_tool_suite.sh
# or if you set up the default alias:
dtools

CLI / Automation Mode:

# Update specific applications (space separated)
dtools update app1 app2

# Update ALL applications
dtools update --all

# Update unused images (prune dangling)
dtools update-unused

# Quick Backup (supports autocompletion for Docker volumes and paths)
dtools -qb <volume_name> /path/to/backup

Flags:

• --dry-run: Simulate actions without changes (e.g., dtools update --all --dry-run).
• --cron: Optimized for scheduled tasks.

📐 Configuration

• Settings are stored in ~/.config/dtools/config.conf.
• You can change paths, retention policies, and helper images directly inside the script via Settings Manager in the main menu.