Paperless Scanner Integration (SANE/AirScan)

When the printer's web admin password is unknown or scan-to-FTP can't be configured from the touchscreen, scan from the server directly using SANE and the AirScan/eSCL network protocol. No printer configuration needed — the server pulls scans from the printer over the network.

Tested with Brother MFC-J5855DW on Ubuntu 26.04.

Architecture

Server command: scan-to-paperless
  → SANE/AirScan (eSCL over HTTP)
    → Brother MFC (192.168.50.219:80)
      → PDF saved to /mnt/seagate8tb/paperless/consume/
        → Paperless auto-ingests (OCR, classify, tag)

Setup

1. Install sane-airscan

sudo apt install -y sane-airscan sane-utils

No Brother drivers needed — sane-airscan uses the driverless eSCL/AirScan protocol that most modern network MFCs support.

2. Verify detection

scanimage -L
# Should show:
# device `airscan:e0:Brother MFC-J5855DW' is a eSCL Brother MFC-J5855DW ip=192.168.50.219

3. Fix consume folder permissions

The consume folder may be owned by a Docker-created user. Add ACL for the local user:

sudo setfacl -m u:ray:rwx /mnt/seagate8tb/paperless/consume

4. Install scan script

sudo tee /usr/local/bin/scan-to-paperless << 'SCRIPT'
#!/bin/bash
set -e

DEVICE="airscan:e0:Brother MFC-J5855DW"
CONSUME="/mnt/seagate8tb/paperless/consume"
MODE="Color"
RES="300"
SOURCE="ADF"

NAME=""
while [[ $# -gt 0 ]]; do
    case "$1" in
        --flatbed) SOURCE="Flatbed" ;;
        --gray)    MODE="Gray" ;;
        --150dpi)  RES="150" ;;
        *)         NAME="$1" ;;
    esac
    shift
done

SCAN_OPTS="--mode $MODE --resolution $RES"
[ "$SOURCE" = "ADF" ] && SCAN_OPTS="$SCAN_OPTS --source ADF --batch-count=1"

TIMESTAMP=$(date +%Y%m%d_%H%M%S)
FILENAME="${NAME:-scan}_${TIMESTAMP}.pdf"
OUTFILE="$CONSUME/$FILENAME"

echo "Scanning ($SOURCE, $MODE, ${RES}dpi) → $FILENAME"
scanimage --device "$DEVICE" $SCAN_OPTS --format pdf -o "$OUTFILE"

SIZE=$(du -h "$OUTFILE" | cut -f1)
echo "Done — $SIZE saved to Paperless"
SCRIPT

sudo chmod +x /usr/local/bin/scan-to-paperless

Usage

scan-to-paperless                 # ADF, color 300dpi
scan-to-paperless invoice         # names it "invoice_20260614_172310.pdf"
scan-to-paperless --flatbed       # use flatbed instead of document feeder
scan-to-paperless --gray          # black & white
scan-to-paperless --150dpi        # lower resolution (smaller file)
scan-to-paperless receipt --flatbed --gray  # combine flags

Pitfalls

/usr/local/bin may be noexec: If direct execution fails, use bash /usr/local/bin/scan-to-paperless or install the script to ~/.local/bin/.
No paper in ADF: If the ADF is empty, scanimage exits with error. The set -e in the script catches this. Use --flatbed if loading a single page.
Permission denied on consume folder: Docker often creates the consume folder with root ownership. Use setfacl to grant the local user write access without changing Docker's ownership.
vsftpd nologin shell: If also setting up FTP, vsftpd's PAM rejects /usr/sbin/nologin. Add it to /etc/shells.

3.1 KiB Raw Blame History