1. Overview
  2. Admin Guide
  3. Installation
  4. DashboardFox Docker Container Maintenance

DashboardFox Docker Container Maintenance

Overview

This guide covers essential maintenance tasks for DashboardFox Docker containers, including restarting services and collecting log files for support cases.

Prerequisites

  • SSH access to the Docker host
  • User account with sudo privileges
  • Docker installed and running

Container Information

DashboardFox runs in two main containers:

  • dashboardfox-app: UI/API service (image: app-dashboardfox:latest)
  • dashboardfox-master: Backend services (image: app-dashboardfox-master:latest)

1. Check Container Status

View all running DashboardFox containers:

sudo docker ps --filter name=dashboardfox

This shows container names, status, and port mappings.

2. Restart DashboardFox Services

Restart Both Containers

sudo docker restart dashboardfox-app
sudo docker restart dashboardfox-master

Verify Restart and Monitor Logs

sudo docker ps --filter name=dashboardfox
sudo docker logs -f dashboardfox-app

Press Ctrl+C to exit log monitoring.

3. Collect Log Files for Support

Step 1: Create Log Archives

Extract logs from both containers to your home directory:

sudo docker exec dashboardfox-app tar -C /var/dashboardfox -czf - logs > ~/dashboardfox-app-logs.tar.gz
sudo docker exec dashboardfox-master tar -C /var/dashboardfox -czf - logs > ~/dashboardfox-master-logs.tar.gz

Step 2: Verify Log Collection

tar -tzf ~/dashboardfox-app-logs.tar.gz | head
tar -tzf ~/dashboardfox-master-logs.tar.gz | head

Step 3: Provide to Support

The collected files (dashboardfox-app-logs.tar.gz and dashboardfox-master-logs.tar.gz) can now be attached to your support case.

4. Troubleshooting with Fresh Logs

When working with support to reproduce an issue, follow these steps:

Clear Existing Logs

sudo docker exec dashboardfox-app sh -lc 'rm -rf /var/dashboardfox/logs/* /var/dashboardfox/logs/.* 2>/dev/null || true'
sudo docker exec dashboardfox-master sh -lc 'rm -rf /var/dashboardfox/logs/* /var/dashboardfox/logs/.* 2>/dev/null || true'

Restart Services

sudo docker restart dashboardfox-app
sudo docker restart dashboardfox-master

Reproduce the Issue

Perform the steps that cause the problem.

Collect Fresh Logs

sudo docker exec dashboardfox-app tar -C /var/dashboardfox -czf - logs > ~/dashboardfox-app-logs-fresh.tar.gz
sudo docker exec dashboardfox-master tar -C /var/dashboardfox -czf - logs > ~/dashboardfox-master-logs-fresh.tar.gz

5. Additional Useful Commands

View Recent Container Logs

sudo docker logs --since=10m dashboardfox-app
sudo docker logs --since=10m dashboardfox-master

List Log Files Inside Container

sudo docker exec dashboardfox-app sh -lc 'ls -lah /var/dashboardfox/logs'
sudo docker exec dashboardfox-master sh -lc 'ls -lah /var/dashboardfox/logs'

Copy Individual Log Files

sudo docker cp dashboardfox-app:/var/dashboardfox/logs/app.log ~/app.log

Quick Reference

Task Command
Check container status sudo docker ps --filter name=dashboardfox
Restart both containers sudo docker restart dashboardfox-app dashboardfox-master
Collect all logs sudo docker exec dashboardfox-app tar -C /var/dashboardfox -czf - logs > ~/dashboardfox-app-logs.tar.gz
View recent logs sudo docker logs --since=10m dashboardfox-app
Clear log files sudo docker exec dashboardfox-app sh -lc 'rm -rf /var/dashboardfox/logs/* /var/dashboardfox/logs/.* 2>/dev/null || true'

Need Help?

If containers fail to start or you encounter permission errors, contact DashboardFox support with the collected log files and details about the issue.