SavaPage

SavaPage User Manual

Version 1.4.0-rc

Rijk Ravestein

SavaPage User Manual © 2011-2022 by Rijk Ravestein is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

SavaPage Open Print Portal Software © 2011-2022 by Datraverse B.V. is OSI Certified Open Source Software , licensed under the terms of the GNU Affero General Public License (AGPL) version 3, or any later version, in compliance with Third Party Software Licenses. OSI Certified is a certification mark of the Open Source Initiative.


Table of Contents

Preface
1. About this Manual
2. Expectations and Prerequisites
3. Conventions used in this Document
3.1. Typographical Conventions
3.2. Feature Preview
3.3. Notes
4. Screenshots
5. Notice
6. Your Feedback
1. Introduction
1.1. What is SavaPage?
1.1.1. Open Source Software
1.1.2. Benefits
1.1.3. Key Features
1.2. System Requirements
1.2.1. Server
1.2.2. Clients
1.3. How does SavaPage work?
1.3.1. Key Concepts
1.3.2. The SavaPage Work Flow
1.3.3. Architecture Overview
2. Server Installation
2.1. Step 1 - System Requirements
2.2. Step 2 - Create System Account
2.3. Step 3 - Configure CUPS and Samba
2.3.1. CUPS Remote Printer Browsing
2.3.2. CUPS Job History
2.3.3. CUPS Job ID
2.3.4. CUPS Job Privacy
2.3.5. CUPS Web Interface
2.3.6. CUPS systemd service
2.3.7. Test CUPS
2.4. Step 4 - Optional System Settings
2.4.1. Set Default Paper Size
2.5. Step 5 - Check Firewall Settings
2.6. Step 6 - Download and Install
2.7. Step 7 - Save Encryption Keys
2.8. Step 8 - Configure
2.8.1. Step 1 - Login
2.8.2. Step 2 - Change Admin Password
2.8.3. Step 3 - Set Locale
2.8.4. Step 4 - Set Currency Code
2.8.5. Step 5 - Set User Source
2.8.6. Step 6 - User Synchronization
2.8.7. Step 7 - Set Mail Options
2.8.8. Step 8 - Set Driverless File Transfer Print
2.9. Step 9 - Share SavaPage Client Files
2.10. Step 10 - Testing
2.11. What's next?
3. User Web App
3.1. Login
3.1.1. About
3.1.2. Select Language
3.1.3. Single Web App Session
3.1.4. Card Self Association Dialog
3.1.5. 2-Step Verification
3.2. Login Alternatives
3.3. SafePages
3.3.1. Document Expiration
3.3.2. Footer
3.3.3. Document Details
3.3.4. Browser
3.4. PDF
3.4.1. PDF Filters
3.4.2. Document Scope
3.4.3. Description
3.4.4. Security
3.4.5. Passwords
3.4.6. Letterhead
3.4.7. Download
3.4.8. Send
3.5. Print
3.5.1. Printer Selection
3.5.2. Printer Settings
3.5.3. Selected Printer
3.5.4. Delegated Print
3.5.5. Print Job Settings
3.5.6. Direct Print Release
3.5.7. Full Print Scope and Jobs
3.5.8. Delegated Print Edit
3.5.9. Job Ticket Print
3.6. Letterheads
3.7. Delete
3.8. Log
3.8.1. Documents
3.8.2. Transactions
3.9. Sort
3.10. User Details
3.10.1. Internet Printer
3.10.2. Telegram Configuration
3.10.3. Authentication
3.10.4. Pagometers
3.10.5. Financial
3.10.6. Redeem Voucher
3.10.7. Transfer Credit
3.10.8. Transfer Money
3.10.9. Send Bitcoins
3.11. Upload
3.11.1. Upload Dialog
3.12. Upload Drop Zone
3.13. GDPR Dialog
4. Admin Web App
4.1. Login
4.2. Menu
4.3. Dashboard
4.3.1. Status
4.3.2. Services
4.3.3. News
4.3.4. Pagometers
4.3.5. Environmental Impact
4.3.6. Financial Summary
4.3.7. Real-time Activity
4.4. Users
4.4.1. User List
4.4.2. Download Personal Data
4.4.3. Erased Users
4.4.4. Edit User
4.4.5. Create Internal User
4.4.6. Deleted Users
4.4.7. Administrator Role
4.5. Groups
4.5.1. Built-in Groups
4.5.2. Group List
4.5.3. Add & Remove Groups
4.5.4. Edit Group
4.6. Accounts
4.6.1. Account List
4.6.2. Edit Account
4.7. Queues
4.7.1. Queue List
4.7.2. Edit Queue
4.7.3. IPP Routing
4.7.4. Reserved Queues
4.8. Proxy Printers
4.8.1. Proxy Printer List
4.8.2. Edit Proxy Printer
4.8.3. Printer Groups
4.8.4. Rename Proxy Printer
4.9. Devices
4.9.1. Network Card Reader
4.9.2. Proxy Print Authentication
4.9.3. Terminal
4.9.4. Custom User Login
4.10. Reports
4.11. Options
4.11.1. User Source
4.11.2. User Creation
4.11.3. User Authentication
4.11.4. Mail
4.11.5. Mail Print
4.11.6. Web Print
4.11.7. Internet Print
4.11.8. Proxy Print
4.11.9. Eco Print
4.11.10. Financial
4.11.11. Integration
4.11.12. Backups
4.11.13. Advanced
4.11.14. Config Editor
4.12. Documents
4.12.1. Document List
4.12.2. Proxy Print Reversal
4.13. Log
4.14. About
4.14.1. Version
4.14.2. License
4.14.3. Community
4.14.4. Support
4.14.5. Java
4.14.6. JavaScript
4.14.7. Host System
4.14.8. Host Packages
4.15. Vouchers
4.15.1. Voucher Actions
4.15.2. Create Vouchers
4.15.3. Voucher Usage
5. Job Tickets Web App
5.1. Login
5.2. Open Tickets
5.2.1. Select and Sort
5.2.2. Ticket List
5.2.3. Job Ticket Bulk Actions
5.2.4. Job Ticket Transactions
5.2.5. Job Ticket Edit
5.2.6. Job Ticket Print
5.2.7. Job Ticket Settle
5.3. Closed Tickets
5.3.1. Job Ticket Refund
5.3.2. Job Ticket Reversal
5.3.3. Job Ticket Reopen
5.4. Ticket Configuration Properties
6. Point-of-Sale Web App
6.1. Login
6.2. Sales
6.3. Deposit
6.4. Receipts
6.5. Configuration Properties
7. Payment Web App
7.1. Login
7.2. Payment Page
7.2.1. Payment Dialog
8. Print Site Web App
8.1. Login
8.2. PaperCut Integration
8.2.1. Users
8.2.2. Financial
8.2.3. Printing
9. PDF/PGP Verification
9.1. PDF/PGP in a Nutshell
9.2. PDF/PGP Signature
9.3. PDF/PGP Verification Web App
10. User Client
10.1. User Client Options
10.2. User Client Deployment
10.2.1. Deployment on Windows
10.2.2. Deployment on macOS
10.2.3. Deployment on GNU/Linux
11. SavaPage Financial
12. SavaPage on GNU/Linux
12.1. The Installation Process
12.1.1. Manual extraction
12.1.2. The install process
12.2. Logs
12.3. OpenPGP Settings
12.4. IP Address Restriction
12.4.1. CIDR Notation
12.4.2. CIDR Set
12.5. Advanced Configuration
12.5.1. Alternative TCP/IP Settings
12.5.2. HTTP XFF Header Settings
12.5.3. Database Connection Settings
12.5.4. CUPS Settings
12.5.5. Server-side Download
12.5.6. RESTful Client
12.5.7. User Home Clean
12.5.8. Database Locking
12.5.9. pdf2cairo Image Strategy
12.5.10. Alternative File Locations
12.5.11. Miscellaneous Settings
12.6. Upgrading SavaPage
12.7. Removing SavaPage from a GNU/Linux server
13. SavaPage as Printer
13.1. IPP Everywhere and AirPrint
13.1.1. Step 1: Check Avahi configuration
13.1.2. Step 2: Create AirPrint Queue
13.1.3. Step 3: Create Avahi Service File
13.2. PostScript Driver Print
13.3. Printing from GNU/Linux
13.4. Printing from macOS
13.5. Printing from Chrome OS
13.6. Printing from Android
13.6.1. SavaPage Android Print App
13.7. Printing from iOS and iPadOS
13.8. Printing from Windows
13.8.1. Local Printer
13.8.2. IPP Printer
13.9. Driverless File Transfer Print
13.9.1. Processing Driverless PDF Transfer
13.10. PostScript Print Processing
13.10.1. Licensed Fonts
13.10.2. Printing Encrypted PDF
13.10.3. PostScript Configuration Properties
13.11. IP Restricted Printing
13.12. Printer Availability
14. Authenticated Printing
14.1. Key Concepts
14.1.1. User
14.1.2. Person
14.1.3. Abstract User
14.1.4. Domain User
14.1.5. Synchronized User
14.1.6. Synchronized Person
14.1.7. Internal Person
14.1.8. Authenticated User
14.1.9. Authenticated Abstract User
14.1.10. Authenticated Person
14.1.11. Trusted SavaPage Queue
14.1.12. Public SavaPage Queue
14.1.13. IP Based Authentication
14.1.14. Mail Print Authentication
14.1.15. Local User
14.1.16. Local Abstract User
14.1.17. Local Person
14.1.18. User Alias
14.2. Single Sign-On Domains
14.2.1. Authentication Loopholes
14.2.2. Unauthenticated Users
14.3. Peer to Peer Networks
14.4. User Name Aliases
15. Printing Impact
15.1. Financial Impact
15.2. Environmental Impact
15.2.1. Printed Sheet Units
15.2.2. Trees
15.2.3. Energy
15.2.4. Carbon
16. Security
16.1. User Authentication
16.1.1. Login Passwords
16.1.2. PIN Codes
16.1.3. Authentication Tokens
16.1.4. One-time Authentication Tokens
16.1.5. User Dialog
16.2. Access over Internet
16.3. Web Sessions
16.3.1. Web Session Timeout
16.3.2. Web Session Cookies
16.4. SSL Passwords
16.5. Secured JMX Connection
16.6. Encrypted Secrets
16.7. Document Signature
16.8. User Client
16.9. Server Commands
16.10. Web Services
16.11. Log Files
16.12. Network Card Reader
16.13. Internal Services
16.14. External Services
16.15. Vouchers
17. Freedom and Privacy
17.1. Open Source
17.1.1. Libre JavaScript
17.2. General Data Protection Regulation
17.2.1. Data Portability
17.2.2. Data Erasure
17.3. Secure Print Release
17.4. CUPS Privacy
18. Internationalization
18.1. Localization
18.1.1. Notes for Translators
18.2. Internal Fonts
18.2.1. Default Font
18.2.2. CJK Font
18.2.3. Unifont
19. Customization
19.1. Custom Web App
19.1.1. Web App Look-and-feel
19.2. Email Templates
19.2.1. Email Template Syntax
19.2.2. Email Stationary Template
19.2.3. Email Message Template
19.2.4. Email Placeholders Objects
19.2.5. Email Stationary Types
19.2.6. Email Message Types
19.2.7. Custom Template Locations
20. Using an External Database
20.1. Supported Databases
20.2. Migrating to an External Database
20.2.1. Step 1 - Stop SavaPage
20.2.2. Step 2 - Create a Backup
20.2.3. Step 3 - Create new Database in External DBMS
20.2.4. Step 4 - Change SavaPage Connection Parameters
20.2.5. Step 5 - Initialize new Database
20.2.6. Step 6 - Restore Backup into new Database
20.2.7. Step 7 - Restart SavaPage
21. Tuning
21.1. Linux Kernel Parameters
21.1.1. IP Ports
21.1.2. TCP Buffer Sizes
21.1.3. Queue Sizes
21.1.4. Congestion Control
21.1.5. Setting Linux kernel parameters with sysctl
21.2. Linux User Limits
21.2.1. SysVinit User Limits
21.2.2. Systemd User Limits
21.3. JVM Tuning
21.3.1. JVM Memory Allocation
21.3.2. JVM Garbage Collection
21.3.3. JVM Temporary Files
21.4. Server Thread Pooling
21.5. Database Connection Pooling
22. SavaPage Community
22.1. Visitor Period
22.2. Registered Member
22.3. Importing the Member Card
A. Proxy Print Scenarios
A.1. Proxy Print Costs
A.2. Personal Print Scenarios
A.2.1. Personal Print - Non-Secure Scenarios
A.2.2. Personal Print - Secure Scenarios
A.2.3. Personal Print - PaperCut Scenario
A.3. Delegated Print Scenarios
A.3.1. Delegated Print - (Non) Secure & Job Ticket Scenarios
A.3.2. Delegated Print - Job Ticket - PaperCut - Scenario
A.3.3. Delegated Print - PaperCut Scenario
B. NFC Authentication
B.1. Card Number Format
B.2. Local Card Reader
B.3. Network Card Reader Service
C. Tools
C.1. Server Commands
C.1.1. Common Options
C.1.2. addInternalUser
C.1.3. addUserGroup
C.1.4. changeBaseCurrency
C.1.5. deleteUser
C.1.6. deleteUserGroup
C.1.7. deleteUserGroupAccount
C.1.8. eraseUser
C.1.9. getConfigProperty
C.1.10. listUsers
C.1.11. listUserGroups
C.1.12. listUserGroupMembers
C.1.13. listUserGroupMemberships
C.1.14. listUserSourceGroups
C.1.15. listUserSourceGroupMembers
C.1.16. listUserSourceGroupNesting
C.1.17. printerAccessControl
C.1.18. printerSnmp
C.1.19. setConfigProperty
C.1.20. setUserProperties
C.1.21. setUserGroupProperties
C.1.22. syncUserGroup
C.1.23. syncUsersAndGroups
C.1.24. systemStatus
C.2. Web Services
C.2.1. XML-RPC
C.2.2. JSON-RPC
C.2.3. RESTful API
C.3. Atom Feed Service
C.4. Database Commands
C.4.1. db-check
C.4.2. db-check-fix
C.4.3. db-config-get
C.4.4. db-config-set
C.4.5. db-delete-logs
C.4.6. db-export and db-export-to
C.4.7. db-import
C.4.8. db-init
C.5. Stopping and Starting the Server
C.6. SSL Key Generation
C.6.1. Re-Create the Self-Signed Certificate
C.6.2. Importing an Existing SSL Certificate
C.6.3. Installing the Keystore
D. Capacity Planning
D.1. Database Sizing and Growth
D.2. SafePages Sizing and Growth
D.3. Network Bandwidth Planning
E. URL Cheat Sheet
F. File Locations
G. Printable File Types
G.1. Standard File Types
G.1.1. XPS to PDF Installation Instructions
G.2. Advanced File Types
G.3. PDF Font Substitution
H. Upgrading from a Previous Version
H.1. Upgrading the Server
H.2. Upgrading Client Printer Drivers
H.3. Testing the Upgrade
I. Migrating to a New Server
I.1. Upgrade Old Server
I.2. Install New Server
I.3. Freeze Old Server
I.4. Migrate Data to New Server
I.5. Rename Printers
I.6. Update SavaPage Printers
J. Advanced LDAP Configuration
J.1. LDAP Server Default Configuration
J.1.1. OpenLDAP
J.1.2. FreeIPA
J.1.3. Apple Open Directory
J.1.4. Novell eDirectory Defaults
J.1.5. Microsoft Active Directory Defaults
J.1.6. Google Cloud Directory
K. PPD Extensions
K.1. PPD to IPP Mappings
K.1.1. Mapping PPD to IPP
K.1.2. media-source
K.1.3. Mapping PPD to IPP Extensions
K.1.4. Restricting Standard Options
K.2. PPD Rules
K.2.1. Generic PPD Rules
K.2.2. Custom PPD Rules
K.3. IPP Rules
K.3.1. SPConstraint
K.4. Job Extensions
K.4.1. Job Copy Options
K.5. Job Ticket Extensions
K.5.1. Job Ticket Media Options
K.5.2. Job Ticket Sheet Options
K.5.3. Job Ticket Copy Options
K.5.4. Job Ticket Set Options
K.6. Tips and Tricks
K.6.1. Fast Print A4 and Letter to Single Tray
K.7. proxy-print.log
L. IPP Extensions
L.1. Internal IPP Extensions
L.1.1. Internal IPP - PPD Mapping Extensions
L.1.2. Internal IPP Job Extensions
L.1.3. Internal IPP Job Ticket Extensions
L.1.4. Internal IPP Marker
L.2. External IPP Extensions
L.3. IPP Localization
M. SavaPage Plug-ins
M.1. Web API Callback Plug-in
M.1.1. Payment Gateway Plug-in
M.2. OAuth Client Plug-in
M.3. Notification Plug-in
M.4. IPP Routing Plug-in
N. PaperCut Integration
N.1. Delegated Print to PaperCut
N.1.1. PaperCut Configuration
N.1.2. PaperCut Delegated Print Processing
N.1.3. PaperCut Delegated Print Accounting
N.1.4. PaperCut Queries and Reports
N.2. Personal Print to PaperCut
N.3. Advanced Print Configuration
N.3.1. PaperCut Print Log Monitoring
N.4. PaperCut User Sync and Auth Interface
N.5. PaperCut Personal User Account
N.6. Integration Pitfalls
O. Job Scheduling
O.1. Cron Trigger Format
O.2. Hourly Jobs
O.3. Daily Jobs
O.4. Daily Maintenance
O.5. Weekly Jobs
O.6. Monthly Jobs
O.7. Atom Feed Job
P. GNU Affero General Public License (AGPL)

List of Figures

1.1. SavaPage High-Level Architecture
2.1. CUPS Job Privacy
3.1. Web App: Login Dialog
3.2. Web App: Select Language Dialog
3.3. Same type Web App session detected
3.4. Web App type change detected
3.5. Web App: Login Dialog - Card Self Association
3.6. Web App: Login Dialog - 2-Step Verification
3.7. Web App: Login Dialog - 2-Step Verification (recovery)
3.8. Web App: Login Dialog - ID Number
3.9. Web App: Login Dialog - Local NFC Card
3.10. Web App: Login Dialog - Network NFC Card
3.11. User Web App: Main View
3.12. User Web App: SafePages
3.13. User Web App: SafePages - Aggregated
3.14. User Web App: Footer Base
3.15. User Web App: Hold Print Jobs
3.16. User Web App: Hold Copy Job
3.17. User Web App: Hold Job Transactions
3.18. User Web App: Document Details
3.19. User Web App: Landscape Job
3.20. User Web App: Rotated Pages
3.21. User Web App: SafePage Browser (8 pages)
3.22. User Web App: SafePage Browser - Page Options
3.23. User Web App: SavaPage Draw
3.24. User Web App: PDF - Overview
3.25. User Web App: PDF - Document Scope
3.26. User Web App: PDF - Description
3.27. User Web App: PDF - Security
3.28. User Web App: PDF - Passwords
3.29. User Web App: PDF - Letterhead
3.30. User Web App: PDF - Send
3.31. User Web App: Print - Select Printer
3.32. User Web App: Printer - Settings
3.33. User Web App: Printer - Settings - Finishings
3.34. User Web App: Printer - Settings - Job Ticket
3.35. User Web App: Print - Page Scaling (Fit)
3.36. User Web App: Print - Page Scaling (None)
3.37. User Web App: Print - Preview (4-up, landscape, staple, punch)
3.38. User Web App: Printer Options - Custom Icons
3.39. User Web App: Print - Selected Printer
3.40. User Web App: Print - Job Settings
3.41. User Web App: Print - Delete Pages
3.42. User Web App: Print Archive Option
3.43. User Web App: Printer - Direct Print Release
3.44. User Web App: Print Delegation Copies
3.45. User Web App: Delegated Print - Group Invoicing
3.46. User Web App: Delegated Print - Group copies
3.47. User Web App: Delegated Print - User Invoicing (Groups)
3.48. User Web App: Delegated Print - Personal Invoicing (Users)
3.49. User Web App: Delegated Print - Shared Account Invoicing (Groups)
3.50. User Web App: Print - Delegated Print - Shared Account Invoicing (Extra)
3.51. User Web App: Print - Select Job Ticket Printer
3.52. User Web App: Print - Job Ticket Settings - Print
3.53. User Web App: Print - Job Ticket Settings - Labels
3.54. User Web App: Print - Job Ticket Settings - Copy
3.55. User Web App: Print - Job Ticket Settings
3.56. User Web App: Print - Job Ticket - Sent
3.57. User Web App: Letterheads
3.58. User Web App: Letterhead - New
3.59. User Web App: Letterhead - Detail
3.60. User Web App: Delete SafePages
3.61. User Web App: Log - Documents
3.62. User Web App: Log - Document Transactions
3.63. User Web App: Log - Queue Journal
3.64. User Web App: Log - Transactions
3.65. User Web App: Log - SavaPage User Account Transaction
3.66. User Web App: Log - Proxy Print PaperCut Transaction
3.67. User Web App: Log - IPP Routing Transaction
3.68. User Web App: Log - Voucher Transaction
3.69. User Web App: Log - Payment Gateway Transactions
3.70. User Web App: Log - User Transfer Transactions
3.71. User Web App: Log - Bitcoin Transaction
3.72. User Web App: Log - Transactions
3.73. User Web App: Sort
3.74. User Web App: User Details - Internet Printer
3.75. User Web App: User Details - Telegram Configuration
3.76. User Web App: User Details - Authentication
3.77. User Web App: User Details - pagometer
3.78. User Web App: User Details - Environmental Impact
3.79. User Web App: User Details - Financial
3.80. User Web App: Redeem Voucher
3.81. User Web App: Transfer Credit
3.82. User Web App: Transfer Money from Credit Card
3.83. User Web App: Send Bitcoins
3.84. Web Print: Upload File
3.85. Web Print: Drop Zone - Upload Dialog
3.86. Web Print: Drop Zone - Main
3.87. User Web App - GDPR Dialog
4.1. Admin Web App: Login
4.2. Admin Web App: Menu
4.3. Admin Web App: Action Pop-up Menu
4.4. Admin Web App: Dashboard - Membership
4.5. Admin Web App: Dashboard - System Mode
4.6. Admin Web App: Dashboard - Setup is needed
4.7. Admin Web App: Dashboard - Users
4.8. Admin Web App: Dashboard - User Home Clean
4.9. Admin Web App: Dashboard - Sessions and Messages
4.10. Admin Web App: Dashboard - OpenPGP
4.11. Admin Web App: Dashboard - Tickets
4.12. Admin Web App: Dashboard - Technical Information
4.13. Admin Web App: Dashboard - Deadlocked Threads (intentionally caused as example)
4.14. Admin Web App: Dashboard - Services
4.15. Admin Web App: Dashboard - Pagometer
4.16. Admin Web App: Dashboard - Pagometer Trend
4.17. Admin Web App: Dashboard - Pagometer Print-in PDF
4.18. Admin Web App: Dashboard - Environmental Impact
4.19. Admin Web App: Dashboard - Financial Summary
4.20. Admin Web App: Dashboard - Real-time Activity
4.21. Admin Web App: User - List
4.22. Admin Web App: User - Select and Sort
4.23. Admin Web App: User - List Item
4.24. Admin Web App: User - PaperCut Account Balance
4.25. Admin Web App: User Data Portability
4.26. Admin Web App: Erased User
4.27. Admin Web App: Edit External User - Identity
4.28. Admin Web App: Edit User - Roles
4.29. Admin Web App: Edit User - Email
4.30. Admin Web App: Edit User - Card, PIN, Yubikey
4.31. Admin Web App: Edit User - ID number
4.32. Admin Web App: Edit User - UUID
4.33. Admin Web App: Edit User - OpenPGP
4.34. Admin Web App: Edit User - Financial
4.35. Admin Web App: Internal User - Password Actions
4.36. Admin Web App: Internal User - Password Reset
4.37. Admin Web App: Edit User - Delete
4.38. Admin Web App: User Group - List
4.39. Admin Web App: Group - Select and Sort
4.40. Admin Web App: Group - List Item
4.41. Admin Web App: User Groups - Add & Remove
4.42. Admin Web App: User Group - Edit - Roles
4.43. Admin Web App: User Group - Edit - User Privileges
4.44. Admin Web App: User Group - Edit - Admin Privileges
4.45. Admin Web App: User Group - Edit - New User Settings
4.46. Admin Web App: Account - List
4.47. Admin Web App: Account - List - Sub Accounts
4.48. Admin Web App: Account - SavaPage Account Balance
4.49. Admin Web App: Account - List - Select and Sort
4.50. Admin Web App: Account - Edit
4.51. Admin Web App: Queue - List
4.52. Admin Web App: Queue - Select and Sort
4.53. Admin Web App: Queue - Edit
4.54. Admin Web App: Queue - IPP Routing Options
4.55. Admin Web App: Queue - List - IPP Routing Queue
4.56. Admin Web App: Proxy Printer - List Header
4.57. Admin Web App: Proxy Printer - List Items
4.58. Admin Web App: Proxy Printer - Select and Sort
4.59. Admin Web App: Proxy Printer - Edit - Identity
4.60. Admin Web App: Proxy Printer - Edit -Job Ticket Printer
4.61. Admin Web App: Proxy Printer - Edit - Media Source
4.62. Admin Web App: Proxy Printer - Edit - Job Sheet Media Sources
4.63. Admin Web App: Proxy Printer - Edit - Manual Media Source
4.64. Admin Web App: Proxy Printer - Edit - Manual Media Size (Simple)
4.65. Admin Web App: Proxy Printer - Edit - Manual Media Size (Advanced)
4.66. Admin Web App: Proxy Printer - Rename
4.67. Admin Web App: Device - List
4.68. Admin Web App: Device - Select and Sort
4.69. Admin Web App: Devices - Network Card Reader - Custom User Login
4.70. Admin Web App: Devices - Network Card Reader - Proxy Print Authentication
4.71. Admin Web App: Devices - Terminal - Custom Proxy Print
4.72. Admin Web App: Devices - Terminal - Custom Proxy Print
4.73. Admin Web App: Devices - Terminal - Custom User Login
4.74. Admin Web App: Devices - Terminal - Custom User Login - Default
4.75. Admin Web App: Print Invoicing Report
4.76. Admin Web App: Options - User Source
4.77. Admin Web App: Options - User Source - LDAP
4.78. Admin Web App: Options - User Source - LDAP
4.79. Admin Web App: Options - Internal Users
4.80. Admin Web App: Options - User Creation - Import
4.81. Admin Web App: Options - User Creation - From Group
4.82. Admin Web App: Options - User Creation - Synchronize
4.83. Admin Web App: Options - User Creation - On Demand
4.84. Admin Web App: Options - User Authentication
4.85. Admin Web App: Options - User Authentication - Login Methods
4.86. Admin Web App: Options - User Authentication - Username Login
4.87. Admin Web App: Options - User Authentication - Email Login
4.88. Admin Web App: Options - User Authentication - ID Number Login
4.89. Admin Web App: Options - User Authentication - Local NFC Card Login
4.90. Admin Web App: Options - User Authentication - YubiKey Login
4.91. Admin Web App: Options - User Authentication - Default Login
4.92. Admin Web App: Options - User Authentication - 2-Step Verification
4.93. Admin Web App: Options - Mail - SMTP
4.94. Admin Web App: Options - Mail - Messages
4.95. Admin Web App: Options - Mail - Test
4.96. Admin Web App: Options - Mail Print (IMAP)
4.97. Admin Web App: Options - Mail Print (Attachments)
4.98. Admin Web App: Options - Web Print
4.99. Admin Web App: Options - Internet Print
4.100. Admin Web App: Options - Proxy Print General
4.101. Admin Web App: Options - Proxy Print Modes
4.102. Admin Web App: Options - Proxy Print Delegation
4.103. Admin Web App: Options - Eco Print
4.104. Admin Web App: Options - Financial - Currency
4.105. Admin Web App: Options - Financial - General
4.106. Admin Web App: Options - Financial - POS
4.107. Admin Web App: Options - Financial - Vouchers
4.108. Admin Web App: Options - Financial - Transfer funds
4.109. Admin Web App: Options - PaperCut Integration
4.110. Admin Web App: Options - PaperCut Server
4.111. Admin Web App: Options - PaperCut Database
4.112. Admin Web App: Options - PaperCut Delegated Print Integration
4.113. Admin Web App: Options - PaperCut Personal Print Integration
4.114. Admin Web App: Options - Backups
4.115. Admin Web App: Options - Automatic Backups
4.116. Admin Web App: Options - Advanced - User Client
4.117. Admin Web App: Options - Advanced - User Name Aliases
4.118. Admin Web App: Options - Advanced - Reset Admin Password
4.119. Admin Web App: Options - Advanced - JMX Agent
4.120. Add JMX Connection with Java VisualVM
4.121. Connecting to Remote Process with JConsole
4.122. Admin Web App: Options - Advanced - Locale
4.123. Admin Web App: Options - Default Paper Size
4.124. Admin Web App: Options - Default Paper Size
4.125. Admin Web App: Options - Converters
4.126. Admin Web App: Options - Advanced - Proxy Printing
4.127. Admin Web App: Options - Advanced - Document Store
4.128. Admin Web App: Options - Advanced - Telegram Messaging
4.129. Admin Web App: Options - Advanced - Pagometers
4.130. Admin Web App: Configuration Editor - List
4.131. Admin Web App: Configuration Property - Edit
4.132. Admin Web App: Document - List
4.133. Admin Web App: Document - IPP Routing
4.134. Admin Web App: Document - Proxy Print PaperCut Costs
4.135. Admin Web App: Documents - Print-in - PDF out
4.136. Admin Web App: Documents - Select and Sort - All
4.137. Admin Web App: Documents - Select and Sort - In
4.138. Admin Web App: Documents - Select and Sort - Out
4.139. Admin Web App: Documents - Select and Sort - PDF
4.140. Admin Web App: Documents - Select and Sort - Print
4.141. Admin Web App: Documents - Select and Sort - Ticket
4.142. Admin Web App: Log - List
4.143. Admin Web App: Log - Select and Sort
4.144. Admin Web App: Log - Select Date
4.145. Admin Web App: About
4.146. Admin Web App: About - Version
4.147. Admin Web App: About - License
4.148. Admin Web App: About - Community
4.149. Admin Web App: About - Import Member Card
4.150. Admin Web App: About - Support
4.151. Admin Web App: About - Java
4.152. Admin Web App: About - JavaScript
4.153. Admin Web App: About - Host Packages - 1/3
4.154. Admin Web App: About - PDF Standard Font Substitutes - 2/3
4.155. Admin Web App: About - Host Packages - 3/3
4.156. Admin Web App: Voucher List
4.157. Admin Web App: Vouchers - Select and Sort
4.158. Admin Web App: Voucher Actions
4.159. Admin Web App: Create Vouchers
5.1. Job Ticket Web App: Login
5.2. Job Tickets: Open Tickets - Select and Sort
5.3. Job Tickets: Open Tickets - Group
5.4. Job Tickets: Open Tickets - List
5.5. Job Tickets: Cancel All
5.6. Job Tickets: Print All
5.7. Job Tickets: Close All
5.8. Job Tickets: Transactions
5.9. Job Tickets: Edit Ticket
5.10. Job Tickets: Print Ticket
5.11. Job Tickets: Print Pending
5.12. Job Tickets: Print Pending (external)
5.13. Job Tickets: Print Canceled
5.14. Job Tickets: Print Completed
5.15. Job Tickets: Print Completed (external)
5.16. Job Tickets: Settle Ticket
5.17. Job Tickets: Closed Ticket List
5.18. Job Ticket: Refund
5.19. Job Ticket: Refund Transactions
5.20. Job Ticket: Reopen Print Ticket
5.21. Job Ticket: Reopen Copy Ticket
5.22. Job Ticket: Reopened Print Ticket
5.23. Job Ticket: Reopened Ticket Printed
6.1. Point-of-Sale Web App: Login
6.2. Point-of-Sale: Deposit Start
6.3. Point-of-Sale: Deposit Completed
6.4. Point-of-Sale: Receipts
7.1. Payment Web App: Login
7.2. Payment Web App: Main Page
7.3. Payment Web App: Payment
8.1. Print Site Web App: Login
8.2. Print Site Web App: Menu
9.1. PDF/PGP Verify Link
9.2. PDF/PGP Verification - Upload
9.3. PDF/PGP Verification - Good signature
9.4. PDF/PGP Verification - Public key not found
9.5. PDF/PGP Verification - Signature not found
12.1. Rejected request in Firefox browser
13.1. SavaPage Android Print App - Printer List
13.2. SavaPage Android Print App - Menu
13.3. SavaPage Android Print Service
13.4. SavaPage Local Printer on Windows
13.5. SavaPage Shared Local Printer on Windows
13.6. SavaPage IPP Printer on Windows (default queue)
14.1. SavaPage in a Single Sign-On Domain
14.2. IP Based Authentication for Abstract User
14.3. IP Based Authentication for Unauthenticated User
14.4. IP Based Authentication in Peer-to-Peer Network
17.1. Web App - About Dialog - Software & Privacy Section
17.2. Web App - JavaScript Info (first 2 of 20+ sources)
19.1. User Web App: Custom CSS - Sample #1
19.2. User Web App: Custom CSS - Sample #2
C.1. JSON-RPC : Basic Error
C.2. JSON-RPC : systemStatus (request)
C.3. JSON-RPC : systemStatus (response)
C.4. JSON-RPC : authUserSource (request)
C.5. JSON-RPC : authUserSource (response)

List of Tables

1. Typographical conventions
3.1. SavaPage Draw - Buttons (top to bottom)
3.2. Page Scaling Configuration Properties
3.3. Basic IPP Printer Attributes
3.4. Print Job Settings Configuration Properties
3.5. Print Job Archive Configuration Properties
3.6. Delegated Print Configuration Properties
3.7. Job Ticket Print Configuration Properties
3.8. Document Type Select: Configuration Property
3.9. User Web App Environmental Impact Configuration Properties
3.10. Configuration Properties for Web Print Document Types
3.11. Configuration Properties for User Web App GDPR
4.1. Admin Web App Environmental Impact Configuration Properties
4.2. User Roles
4.3. Configuration Properties for User ID number
4.4. Queue Icon
4.5. Configuration Properties for IPP Routing
4.6. Primary Printer Icons
4.7. Secondary Printer Icons
4.8. Configuration Properties for Printer SNMP
4.9. YubiKey Configuration Properties
4.10. 2-Step Verification Issuer Properties
4.11. Mail Configuration Properties
4.12. Mail Print Configuration Properties
4.13. LibreOffice Configuration Properties
4.14. Document Store Configuration Properties
4.15. Telegram Messaging Configuration Properties
5.1. Job Ticket Print Configuration Properties
6.1. Point-of-Sale Configuration Properties
9.1. PDF/PGP Signing Configuration Properties
9.2. PDF/PGP Verification Web App Configuration Properties
10.1. User Client Access Configuration Properties
10.2. User Client Options Configuration Properties
12.1. Secured Application Areas
12.2. Log Files
12.3. OpenPGP Server Properties
12.4. OpenPGP Configuration Properties
12.5. Server Properties: Alternative TCP/IP Ports
12.6. Server Properties: ThreadPool Settings
12.7. Server Properties: Session Settings
12.8. HTTP Configuration Properties
12.9. Database Connection Settings
12.10. CUPS Configuration Properties
12.11. Server-side Download Configuration Properties
12.12. RESTful Client Configuration Properties
12.13. User Home Clean Configuration Properties
12.14. Database Locking Configuration Properties
12.15. pdf2cairo Image Strategy Configuration Property
12.16. Server Properties for Alternative File Locations
12.17. Server Properties: Miscellaneous Settings
13.1. IPP Everywhere and AirPrint
13.2. Printing from GNU/Linux
13.3. Printing from macOS
13.4. Printing from Chrome OS
13.5. Printing from Android
13.6. Printing from iOS and iPadOS
13.7. Printing from Windows
13.8. Driverless PDF Transfer Processing Configuration Properties
13.9. PostScript Print Configuration Properties
16.1. Web App Internet Access Configuration Properties
16.2. Default Web Session Timeout Values
16.3. Web Session Timeout Configuration Properties
19.1. Stock Image Identifiers
19.2. Placeholder: Stationary
19.3. Placeholder: Application
19.4. Placeholder: Ticket
19.5. Placeholder: User
19.6. Email Stationary Types
19.7. Placeholder Objects: JobTicketCanceled
19.8. Placeholder Objects: JobTicketCompleted
19.9. Configuration Properties for Custom Template Locations
A.1. Personal Print - PaperCut Scenario
A.2. Delegated Print - (Non) Secure & Job Ticket Scenarios
A.3. Delegated Print - Job Ticket - PaperCut Scenario
A.4. Delegated Print - PaperCut Scenario
C.1. XML-RPC method: onetime-auth.createToken
C.2. JSON-RPC Configuration Properties
C.3. RESTful Admin Services Configuration Properties
C.4. Atom Feed Configuration Properties
D.1. Database size increase metrics per document flow.
E.1. SavaPage URL Cheat Sheet
F.1. SavaPage File Locations
G.1. Standard Printable File Types
G.2. Advanced Printable File Types
J.1. LDAP Configuration Properties
J.2. OpenLDAP Default Settings
J.3. Apple Open Directory Default Settings
J.4. Novell eDirectory Default Settings
J.5. Microsoft Active Directory Default Settings
J.6. Microsoft Active Directory Custom Settings
L.1. Internal IPP Attribute: org.savapage-finishings-staple
L.2. Internal IPP Attribute: org.savapage-finishings-punch
L.3. Internal IPP Attribute: org.savapage-finishings-fold
L.4. Internal IPP Attribute: org.savapage-finishings-booklet
L.5. Internal IPP Attribute: org.savapage-finishings-jog-offset
L.6. Internal IPP Attribute: org.savapage-cover-front-type
L.7. Internal IPP Attribute: org.savapage-cover-back-type
L.8. Internal IPP Attribute: org.savapage-finishings-ext
L.9. Internal IPP Attribute: org.savapage-cover-type
L.10. Internal IPP Attribute: org.savapage-job-sheets
L.11. Internal IPP Marker Attribute: org.savapage.int-page-rotate180
M.1. Web API Callback Configuration Property
M.2. Payment Gateway Configuration Property
M.3. IPP Routing Plug-in: .properties keys
N.1. PaperCut User Sync and Auth Interface Configuration Properties
N.2. PaperCut Personal User Account Configuration Settings
O.1. Cron Trigger Format - simplified