KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

fluentd-docker-image

★ 466 Open GitHub ↗

Docker image for Fluentd

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Fluentd Docker Image
====================

[![Build Status](https://github.com/fluent/fluentd-docker-image/actions/workflows/linux.yml/badge.svg?branch=master)](https://github.com/fluent/fluentd-docker-image/actions/workflows/linux.yml)
[![Docker Stars](https://img.shields.io/docker/stars/fluent/fluentd.svg)](https://hub.docker.com/r/fluent/fluentd)
[![Docker Pulls](https://img.shields.io/docker/pulls/fluent/fluentd.svg)](https://hub.docker.com/r/fluent/fluentd)

## What is Fluentd?

Fluentd is an open source data collector, which lets you unify the data
collection and consumption for a better use and understanding of data.

> [www.fluentd.org](https://www.fluentd.org/)

![Fluentd Logo](https://www.fluentd.org/images/miscellany/fluentd-logo.png)

## Supported tags and respective `Dockerfile` links

### Current images (Edge)

These tags have image version postfix. This updates many places so we need feedback for improve/fix the images.

Current images use fluentd v1 series.

- `v1.19.3-2.2`, `v1.19-2`, `edge`, `latest`
  [(v1.19/debian/Dockerfile)][fluentd-1-debian] (Since v1.19.0, alpine image will not be shipped anymore.)
- `v1.19.3-debian-2.2`, `v1.19-debian-2`, `edge-debian`
  (multiarch image for arm64(AArch64), armhf and amd64(x86_64))
- `v1.19.3-debian-amd64-2.2`, `v1.19-debian-amd64-2`, `edge-debian-amd64`
  [(v1.19/debian/Dockerfile)][fluentd-1-debian]
- `v1.19.3-debian-arm64-2.2`, `v1.19-debian-arm64-2`, `edge-debian-arm64`
  [(v1.19/arm64/debian/Dockerfile)][fluentd-1-debian-arm64]
- `v1.19.3-debian-armhf-2.2`, `v1.19-debian-armhf-2`, `edge-debian-armhf`
  [(v1.19/armhf/debian/Dockerfile)][fluentd-1-debian-armhf]
- `v1.19.3-windows-ltsc2019-1.1`, `v1.19-windows-ltsc2019-1`
  [(v1.19/windows-ltsc2019/Dockerfile)][fluentd-1-ltsc2019-windows]
- `v1.19.3-windows-ltsc2022-1.1`, `v1.19-windows-ltsc2022-1`
  [(v1.19/windows-ltsc2022/Dockerfile)][fluentd-1-ltsc2022-windows]

> [!TIP]
> About deprecated old images, See [DEPRECATED](DEPRECATED.md)

We recommend to use debian version for production because it uses jemalloc to mitigate memory fragmentation issue.

If you want to know the detail of supported image tags, see [TAGRULE](TAGRULE.md) explanation.

### Using Kubernetes?

Check [fluentd-kubernetes-daemonset](https://github.com/fluent/fluentd-kubernetes-daemonset) images.

## How to use this image

To create endpoint that collects logs on your host just run:

```bash
docker run -d -p 24224:24224 -p 24224:24224/udp -v /data:/fluentd/log fluent/fluentd:v1.3-debian-1
```

Default configurations are to:

- listen port `24224` for Fluentd forward protocol
- store logs with tag `docker.**` into `/fluentd/log/docker.*.log`
  (and symlink `docker.log`)
- store all other logs into `/fluentd/log/data.*.log` (and symlink `data.log`)

## Providing your own configuration file and additional options

`fluentd` arguments can be appended to the `docker run` line

For example, to provide a bespoke config and make `fluentd` verbose, then:

`docker run -ti --rm -v /path/to/dir:/fluentd/etc fluent/fluentd -c /fluentd/etc/<conf> -v`

The first `-v` tells Docker to share '/path/to/dir' as a volume and mount it at /fluentd/etc
The `-c` after the container name (fluentd) tells `fluentd` where to find the config file
The second `-v` is passed to `fluentd` to tell it to be verbose

## Change running user

Use `-u` option with `docker run`.

`docker run -p 24224:24224 -u foo -v ...`

## How to build your own image?

Check [HOWTOBUILD](HOWTOBUILD.md) explanation.

### References

[Docker Logging | fluentd.org][5]

[Fluentd logging driver - Docker Docs][6]

## Issues

We can't notice comments in the DockerHub so don't use them for reporting issue or asking question.

If you have any problems with or questions about this image, please contact us
through a [GitHub issue](https://github.com/fluent/fluentd-docker-image/issues).

[1]: http://alpinelinux.org
[2]: https://hub.docker.com/_/alpine
[3]: https://docs.fluentd.org
[4]: https://www.fluentd.org/plugins
[5]: https://www.fluentd.org/guides/recipes/docker-logging
[6]: https://docs.docker.com/engine/reference/logging/fluentd
[7]: https://hub.docker.com/_/debian
[fluentd-0-12-alpine]: https://github.com/fluent/fluentd-docker-image/blob/master/v0.12/alpine/Dockerfile
[fluentd-0-12-alpine-onbuild]: https://github.com/fluent/fluentd-docker-image/blob/master/v0.12/alpine-onbuild/Dockerfile
[fluentd-0-12-debian]: https://github.com/fluent/fluentd-docker-image/blob/master/v0.12/debian/Dockerfile
[fluentd-0-12-debian-onbuild]: https://github.com/fluent/fluentd-docker-image/blob/master/v0.12/debian-onbuild/Dockerfile
[fluentd-1-4-alpine]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.4/alpine/Dockerfile
[fluentd-1-4-alpine-onbuild]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.4/alpine-onbuild/Dockerfile
[fluentd-1-4-debian]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.4/debian/Dockerfile
[fluentd-1-4-debian-onbuild]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.4/debian-onbuild/Dockerfile
[fluentd-1-4-windows]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.4/windows/Dockerfile
[fluentd-1-debian]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.19/debian/Dockerfile
[fluentd-1-debian-arm64]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.19/arm64/debian/Dockerfile
[fluentd-1-debian-armhf]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.19/armhf/debian/Dockerfile
[fluentd-1-ltsc2019-windows]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.19/windows-ltsc2019/Dockerfile
[fluentd-1-ltsc2022-windows]: https://github.com/fluent/fluentd-docker-image/blob/master/v1.19/windows-ltsc2019/Dockerfile

## FAQ

### Permission Issues with v1.19+

Due to a change in the default UID in `vX.Y-A` and `vX.Y.Z-A.B` images since v1.19,
you may encount permission errors when writing to mounted volumes.
To resolve this, please chown your data directories to the new UID.

For more details, please refer to [#448](https://github.com/fluent/fluentd-docker-image/issues/448).

fluentd-docker-image

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README