printnatura/README.md

# PrintNatura (Print Server)
This project is used to print pdf, it acts as a print server.
## Requeriments

* Git
* Docker

## Installaton
Clone the repository
```
> git clone https://gitea.verdnatura.es/verdnatura/printnatura.git
```

Build
```
> $CUPS_PASSWORD = 1234
> docker build --build-arg CUPS_PASSWORD -t printnatura .
```

Create file named "config.local.yml" and put your private configuration:
```
debug: false
log: true
dryPrint: false
keepFile: false
serverId: null
concurrency: 4
reconnectTimeout: 10
refreshRate: 1000
tmpDir: /dev/shm/printnatura
retryAttempts: 3
retryTimeout: 1000
db:
  host: localhost
  port: 3306
  user: user
  password: password
  database: schema
salix:
  url: http://localhost:3000
  user: user
  password: password
```
## How to use

Exec
```
> docker run --name printnatura -it --rm -v $PWD/config.local.yml:/printnatura/config.local.yml:ro -v $PWD/cupsd.conf:/etc/cups/cupsd.conf:ro -p 80:631 printnatura
```

Bash
```
> docker exec -i -t printnatura bash
```

Has a graphical web interface (cupsd.conf)

## Commands

### Install printer
```
$ lpadmin -p [<printer>] -E -v socket://[<ip>] -m [<driver>]
```

### Print document
```
$ lp [<file>] [<printer>]
```

### Search driver
```
$ lpinfo --make-and-model '[<printer-model>]' -m
```

### Show intalled printers
```
$ lpstat -p
```

### Delete installed printer
```
$ lpadmin -x [<printer>]
```
### [More here](https://www.cups.org/doc/man-lp.html)

## Drivers:
### ZEBRA
Generic driver

_Example:_
```
drv:///sample.drv/zebra.ppd
```
### RICOH
Each printer has its own driver

_Example:_
```
gutenprint.5.3://ricoh-mp_c2011/expert
```
### GODEX
Installed by the Dockerfile (GoDEXdriver-1.1.6.tar.gz)

_Example:_
```
lsb/local/godex/godex-zx420i.ppd
```

## Build With
* [Git](https://git-scm.com/)
* [Nodejs](https://nodejs.org/)
* [Docker](https://www.docker.com/)