Skip to content
BangerTech edited this page Jan 2, 2025 · 1 revision

Frequently Asked Questions (FAQ)

General Questions

What is webDock?

webDock is a web-based interface for managing Docker containers and services on Debian-based systems, providing easy container management, system monitoring, and automated tasks.

Which systems are supported?

  • Debian-based systems (Debian, Ubuntu)
  • Raspberry Pi OS
  • Any Linux system supporting Docker and Docker Compose

Do I need Docker experience?

No, webDock is designed to be user-friendly for both beginners and experienced users.

Installation

What are the minimum system requirements?

  • Debian-based OS
  • 1GB RAM (minimum)
  • 10GB free disk space
  • Internet connection
  • Docker + Docker Compose

Can I install webDock on Windows?

webDock is designed for Linux systems. While Docker runs on Windows, we recommend using Linux for the best experience.

How do I update webDock?

Run the setup script again:

sh setup_webui.sh

Usage

How do I access the web interface?

Access through your web browser at:

http://your-ip:8585

Can I change the default port?

Yes, edit the port mapping in docker-compose.yml:

ports:
  - "new_port:80"

How do I backup my configurations?

All configurations are stored in:

/home/webDock/docker-compose-data

Backup this directory regularly.

Containers

Why isn't my container starting?

Common reasons:

  1. Port conflicts
  2. Insufficient permissions
  3. Resource constraints
  4. Configuration errors

Can I add custom containers?

Yes, through the container management interface or by editing the configuration files.

How do I access container logs?

  1. Through webDock interface
  2. Using Docker commands:
docker logs container_name

Security

Is the web interface secure?

  • Uses HTTPS when configured
  • Password protection available
  • Regular security updates

How do I secure SSH access?

  1. Use strong passwords
  2. Enable key-based authentication
  3. Configure proper permissions

Can I restrict access to specific IPs?

Yes, through your system's firewall configuration or reverse proxy settings.

Troubleshooting

What do I do if webDock won't start?

  1. Check Docker status
  2. Verify permissions
  3. Review logs
  4. Ensure ports are available

How do I reset my configuration?

  1. Backup your data
  2. Remove the webDock directory
  3. Run setup script again

Where can I get help?

  • Check this Wiki
  • GitHub Issues
  • Community Discussions
  • Direct Support