acepanel.github.io/en/faq/container.md

Container FAQ

Image Pull Failed

Servers in China cannot connect to Docker Hub and need to configure mirror acceleration.

Docker

Apps -> Docker -> Manage -> Configuration, add:

{
  "registry-mirrors": [
    "https://docker.1ms.run"
  ]
}

Podman

Apps -> Podman -> Manage -> Registry Configuration, add at the end:

[[registry]]
location = "docker.io"
[[registry.mirror]]
location = "docker.1ms.run"

For mirror acceleration addresses, you can use 1ms Mirror or other services.

Compose Startup Failed

1. Click Logs to view error messages
2. Common causes:
   • Port occupied: Modify the mapped port
   • Image pull failed: Configure mirror acceleration
   • Configuration error: Check docker-compose.yml syntax

Container Inaccessible

1. Check if the container is running: View status in Containers -> Containers list
2. Check if port mapping is correct
3. Check if the firewall has allowed the mapped host port

Container Cannot Access External Network

Check Docker network configuration:

docker network ls
docker network inspect bridge

Data Persistence

Data will be lost after container deletion. Use volume mounts to persist data:

Add volumes in the compose configuration:

volumes:
  - ./data:/app/data

View Container Logs

docker logs container-name-or-id
docker logs -f container-name-or-id  # Real-time view

Or click Logs in the panel Containers -> Containers list.