Docker SANE

Description

Run Dockerised Scanner server to share USB scanners over the network.
Built to be used with Raspberry Pi's.
Tested and confirmed to be working on:

• Raspberry Pi 5 (arm64/AArch64)

Usage

1. Clone this repository:

git clone https://github.com/CXDezign/docker-cups.git

2. Build the Docker image:

docker build -t docker-cups .

3. Create a docker-compose.yml file with the following content, adjusting parameters as needed:

services:
    sane:
        container_name: sane
        image: docker-sane
        restart: unless-stopped
        ports:
            - 8090:8090
        volumes:
            - /etc/sane.d:/etc/sane.d
            - /etc/airsane:/etc/airsane
        devices:
            - /dev/bus/usb:/dev/bus/usb

4. Use Docker Compose to run the Docker image in a container.

docker-compose up -d

Parameters & Environment Variables

Parameter	Default	Description
container_name	sane	Preferred Docker container name.
ports	8090	AIRSANE network port.
volumes	/etc/sane.d, /etc/airsane	Persistent Docker container volume for configuration files (migration or backup purposes).
devices	/dev/bus/usb:/dev/bus/usb	Add host device (USB scanner) to container. Default passes the whole USB bus in case the USB port on your device changes. Change to a fixed USB port if it will remain unchanged, example: /dev/bus/usb/001/005.

Access

AIRSANE web app will be accessible on the defined port of the host machine.

http://<DOCKER_HOST_IP>:8090

Documentation

SANE
SANE Daemon
SANE USB
SANE Network
SANE Find Scanner
SANE Backend DLLs
SANE Server Configuration
AIRSANE