printservant/README.md

# Printservant

HTTP to IPP proxy, a.k.a. HSWAW Rube Goldberg printing microservice.

## Usage

`GET /` to see available API routes

## Quick start

Configuration available:

```
PRINTSERVANT_PORT - Port (default: 3199)
PRINTSERVANT_CONFIG - JSON config, like so:
  {
    printers: [
      {
        name: 'DYMO_LabelWriter450',
        aliases: ['dymo', 'label'],
        ipp_url: 'ipp://$SECRET@printmaster.waw.hackerspace.pl/printers/DYMO_LabelWriter450',
      },
      ...
    ]
  }
PRINTSERVANT_SECRET - Optional, used to substitute $SECRET in printer configs' ipp_urls
```


```
PRINTSERVANT_CONFIG='{"printers":[{"name":"DYMO_LabelWriter450","aliases":["dymo"],"ipp_url":"ipp://printmaster.local:631/printers/DYMO_LabelWriter450"}]}' node index.js
```

or:

```
docker build -t printservant .
docker run --env PRINTSERVANT_CONFIG='... put config here ...' -it -p 3199:3199 printservant
```