# FAQ

> Frequently asked questions about the Pigsty Docker module

---

LLMS index: [llms.txt](/llms.txt)

---

--------

## Who Can Run Docker Commands?

By default, Pigsty adds both the management user running the playbook on the remote node (i.e., the SSH login user on the target node) and the admin user specified in the [`node_admin_username`](/docs/node/param#node_admin_username) parameter to the Docker operating system group.
All users in this group (`docker`) can manage Docker using the `docker` CLI command.

If you want other users to be able to run Docker commands, add that OS user to the docker group:

```bash
usermod -aG docker <username>
```


--------

## Working Through a Proxy

During Docker installation, if the [`proxy_env`](/docs/infra/param#proxy_env) parameter exists,
the HTTP proxy server configuration will be written to the `/etc/docker/daemon.json` configuration file.

Docker will use this proxy server when pulling images from upstream registries.

Tip: Running `configure` with the `-x` flag will write the proxy server configuration from your current environment into `proxy_env`.


--------

## Using Mirror Registries

If DockerHub access is slow in mainland China network environments, you can prioritize:

- Configure available mirrors with [`docker_registry_mirrors`](/docs/docker/param#docker_registry_mirrors)
- Or configure [`proxy_env`](/docs/infra/param#proxy_env) to pull via proxy
- Or directly use other public registries (such as `quay.io`)

For example:

```bash
docker login quay.io    # Enter username and password to log in
```



--------

## Adding Docker to Monitoring

During Docker module installation, you can register Docker as a monitoring target by running the `docker_register` subtask (or alias tag `add_metrics`) for specific nodes:

```bash
./docker.yml -l <your-node-selector> -t docker_register
```



--------

## Using Software Templates

Pigsty provides a collection of [software templates](https://pigsty.io/docs/app/) that can be launched using Docker Compose, ready to use out of the box.

But you need to install the Docker module first.