btrace Docker & Self-Hosted Deployment

GitHub

Production-safe dynamic tracing and diagnostics for Java applications—attach to live JVMs with no restart or recompilation.

5,990 stars Java Java 1 file · ~25,393 tokens #btrace#bytecode-instrumentation#diagnostics#dtrace#java#java-agent#jvm#observability
1. Pull Image (DOCKERHUB) docker pull btraceio/btrace:latest
2. Docker Run (1-Click Launch) docker run -d --name btrace --restart always btraceio/btrace:latest
3. Podman Run podman run -d --name btrace --restart always btraceio/btrace:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/btraceio/btrace:latest
5. ORAS Pull (OCI Artifact) oras pull btraceio/btrace:latest
docker/Dockerfile 
# BTrace Docker Image - Debian-based variant
# Full distribution with all tools and shell access
FROM bellsoft/liberica-openjdk-debian:11.0.32.1-cds

ARG BTRACE_VERSION=3.0.0-SNAPSHOT

LABEL maintainer="BTrace Project <https://github.com/btraceio/btrace>" \
      org.opencontainers.image.title="BTrace" \
      org.opencontainers.image.description="Safe, dynamic tracing tool for the Java platform" \
      org.opencontainers.image.url="https://github.com/btraceio/btrace" \
      org.opencontainers.image.source="https://github.com/btraceio/btrace" \
      org.opencontainers.image.version="${BTRACE_VERSION}" \
      org.opencontainers.image.licenses="Apache-2.0"

# Install required tools
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        procps \
        curl \
        ca-certificates && \
    rm -rf /var/lib/apt/lists/*

# Create BTrace installation directory
RUN mkdir -p /opt/btrace

# Copy BTrace distribution
COPY btrace/ /opt/btrace/

# Set ownership and permissions
RUN chmod -R 755 /opt/btrace/bin && \
    chmod 644 /opt/btrace/libs/*.jar

# Set environment variables
ENV BTRACE_HOME=/opt/btrace \
    PATH="${PATH}:/opt/btrace/bin" \
    JAVA_HOME=/usr/local/openjdk-11

# Verify installation
RUN btrace --version || echo "BTrace installed"

# Add entrypoint script
COPY docker-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/docker-entrypoint.sh

WORKDIR /work

ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
CMD ["/bin/bash"]