File not exists error

[bjgbeelen]

I've tried all kinds of tweaks, but somehow I continuously get the following error when i run the example:

cargo run --example render_pages

  Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.02s
   Running `target/debug/examples/render_pages`
thread 'main' panicked at examples/render_pages.rs:4:57:
called `Result::unwrap()` on an `Err` value: Io(Os { code: 2, kind: NotFound, message: "No such file or directory" })
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

[kuba-04]

I have the same. File exists and I can verify that, the lib fails

[TorbenHammes]

The same goes for me, and I also checked that the lib doesn't work

It also did not work with fs::read and PDF::from_bytes(pdf_bytes) :-/

[Femure]

Root cause identified: missing environment variable for external binaries

I ran into the same issue and after trying multiple tweaks, I finally found the actual cause: it's not related to the PDF path you provide, but rather to a missing environment variable required by the library when it tries to call external tools (pdfinfo, pdftocairo or pdftoppm).

These binaries are invoked in pdf.rs and utils.rs using this function:

pub fn get_executable_path(command: &str) -> String {
    if let Some(poppler_path) = std::env::var("PDF2IMAGE_POPPLER_PATH").ok() {
        if cfg!(windows) {
            return format!("{}\\{}.exe", poppler_path, command);
        } else {
            return format!("{}/{}", poppler_path, command);
        }
    } else {
        if cfg!(windows) {
            return format!("{}.exe", command);
        } else {
            return command.to_string();
        }
    }
}

If PDF2IMAGE_POPPLER_PATH isn’t defined, and the binaries aren’t in the default path, you’ll get this error:

called `Result::unwrap()` on an `Err` value: Io(Os { code: 2, kind: NotFound, message: "No such file or directory" })

---

✅ Solution

Make sure to define the PDF2IMAGE_POPPLER_PATH environment variable, for example:

export PDF2IMAGE_POPPLER_PATH=/usr/bin

This directory must contain the binaries pdfinfo and pdftocairo (or pdftoppm depending on your options).

---

🐳 Docker example (based on my working setup)

Here’s how I handled it in a multi-stage Dockerfile (preserving your structure):

# ---- Stage 1: Build & Bundle Dependencies ----
FROM debian:bookworm AS builder

RUN apt-get update && apt-get install -y --no-install-recommends \
    pkg-config=1.8.* \
    libtesseract-dev=5.3.* \
    tesseract-ocr=5.3.* \
    tesseract-ocr-fra=1:4.1.* \
    libleptonica-dev=1.82.* \
    poppler-utils=22.12.* \
    libpoppler-cpp-dev=22.12.* \
    && rm -rf /var/lib/apt/lists/*

RUN mkdir -p /deps/lib && \
    for bin in $(which pdfinfo) $(which pdftocairo); do \
    for lib in $(ldd "$bin" | awk '$3 ~ /^\// { print $3 }' | sort -u); do \
    cp -av "$lib" /deps/lib/; \
    real=$(readlink -f "$lib"); \
    if [ "$real" != "$lib" ]; then cp -av "$real" /deps/lib/; fi; \
    done; \
    done

RUN mkdir -p /deps/bin && \
    cp -av $(which pdfinfo) /deps/bin/ && \
    cp -av $(which pdftocairo) /deps/bin/

# ---- Stage 2: Minimal Runtime ----
FROM scratch

COPY --from=builder /deps/lib/ /lib/
COPY --from=builder /lib64/ld-linux-x86-64.so.2 /lib64/
COPY --from=builder /deps/bin/ /usr/bin/
COPY --from=builder /usr/share/tesseract-ocr/5/tessdata/ /usr/share/tessdata/

ENV PDF2IMAGE_POPPLER_PATH=/usr/bin
ENV TESSDATA_PREFIX=/usr/share/tessdata

ENTRYPOINT ["/lib64/ld-linux-x86-64.so.2", "--library-path", "/lib", "/usr/bin/pdftocairo"]