Updated README

This commit is contained in:
root
2018-09-18 12:58:47 -05:00
parent f34eb4781a
commit ea2f1bd546

View File

@@ -1,12 +1,14 @@
# quadportnick/cups-airprint # chuckcharlie/cups-airprint-brother
This Ubuntu-based Docker image runs a CUPS instance that is meant as an AirPrint relay for printers that are already on the network but not AirPrint capable. I'm using it on a Synology NAS because the built in server doesn't work properly with my printers. The local Avahi will be utilized for advertising the printers on the network. Fork from [quadportnick/cups-airprint](https://github.com/quadportnick/docker-cups-airprint)
This is also an excuse to dip my toes into GitHub/Docker more, so why not? Hopefully someone else finds this useful. This Ubuntu-based Docker image runs a CUPS instance that is meant as an AirPrint relay for printers that are already on the network but not AirPrint capable. I am running this on CentOS. I forked the original to add support for my Brother MFC=7840w printer, and use the latest Ubuntu base.
## Prereqs ## Prereqs
* No other printers should be shared under Control Panel>External Devices>Printer so that the DSM's CUPS is not running. * Install avahi on local host.
* `Enable Bonjour service discovery` needs to be marked under Control Panel>Network>DSM Settings * `yum install avahi`
* `systemctl start avahi-daemon`
* `systemctl enable avahi-daemon`
## Configuration ## Configuration
@@ -24,9 +26,7 @@ This is also an excuse to dip my toes into GitHub/Docker more, so why not? Hopef
## Using ## Using
CUPS will be configurable at http://[diskstation]:631 using the CUPSADMIN/CUPSPASSWORD when you do something administrative. CUPS will be configurable at http://[diskstation]:631 using the CUPSADMIN/CUPSPASSWORD when you do something administrative.
If the `/services` volume isn't mapping to `/etc/avahi/services` then you will have to manually copy the .service files to that path at the command line.
## Notes ## Notes
* CUPS doesn't write out `printers.conf` immediately when making changes even though they're live in CUPS. Therefore it will take a few moments before the services files update * I had to run the [airprint-generate.py](/root/root/airprint-generate.py) script on the local host to get the avahi service file to generate.
* Don't stop the container immediately if you intend to have a persistent configuration for this same reason * `python airprint-generate.py -H localhost -p 631 -u admin -d <your services dir>`