webDock

🐳 A modern web interface for managing Docker containers and services on Debian-based systems

Screenshots

Table of Contents

• What is webDock?
• Setup & Requirements
• Usage
• Support / Feedback
• Contributing
• Sponsorship

What is webDock?

webDock is a powerful tool for managing and installing software on Debian-based systems. It provides a user-friendly interface for managing Docker containers and other software solutions.

Features

• 🚀 One-click container deployment
• 🔄 Automatic container updates
• 📊 System monitoring and statistics
• 🌙 Dark/Light theme support
• 🔧 Easy configuration management
• 📱 Responsive design
• 🖥️ SSH Terminal access
• 📁 SFTP File Explorer
• ⏰ Cron Job Editor for automated system shutdown/wakeup

Supported Containers

1. openHAB - Open Home Automation Bus
2. Home Assistant - Open-source home automation platform
3. HomeBridge - HomeKit support for non-native devices
4. RaspberryMatic - Homematic central control unit
5. Zigbee2MQTT - Zigbee devices to MQTT bridge
6. MQTT Broker - Message broker for IoT communication
7. Dockge - Docker compose stack manager
8. Portainer - Container management UI
9. Grafana - Analytics and monitoring platform
10. InfluxDB - Time series database
11. Code Server - VS Code in the browser
12. File Browser - Web-based file manager
13. WatchYourLAN - Network device monitoring
14. WhatsUpDocker - Docker container monitoring
15. Frontail - Web-based log viewer
16. Node Exporter - Hardware and OS metrics exporter
17. Prometheus - Monitoring and alerting toolkit

Technologies

• Python 3.9+
• Flask web framework
• Docker & Docker Compose
• JavaScript (ES6+)
• YAML for configuration

Setup & Requirements

• sudo should be installed
• $USER needs to be a member of the sudo group
• Add %sudo ALL=(ALL) NOPASSWD:ALL with visudo
• Docker + Docker-Compose are required for all container-based programs

Usage

For X86 Systems:

1. Navigate to your home directory:

   cd $HOME

2. Download the setup script:

   sudo wget https://raw.githubusercontent.com/BangerTech/webDock/main/setup_webui.sh

3. Make the script executable:

   sudo chmod +x setup_webui.sh

4. Run the setup script:

   sh setup_webui.sh

5. Pick a program and follow the steps presented by the tool.

Quick Start Installation

1. Create a new directory and navigate into it:

mkdir webdock && cd webdock

2. Create a docker-compose.yml file with the following content:

version: '3'
services:
  webdock-ui:
    image: bangertech/webdock:latest
    container_name: webdock-ui
    ports:
      - "8585:80"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./data:/app/data
      - ./config:/app/config
    environment:
      - CONFIG_DIR=/app/config
    restart: unless-stopped

3. Start webDock:

docker compose up -d

4. Access webDock at http://localhost:8585

The necessary directories and configurations will be automatically created on first start.

Support / Feedback

Any bugs or feature requests? Contact me here or click on the "Issues" tab in the GitHub repository!

Contributing

Fork the repository and create pull requests.

Sponsorship

Keywords

docker-management container-management web-ui docker-compose system-monitoring home-automation iot smart-home monitoring dashboard debian raspberry-pi docker-gui container-deployment devops self-hosted open-source