OptimiDoc Server Help Center

Wasabi

The Wasabi print connector turns an S3-compatible cloud bucket into a browsable print source. A signed-in user opens the connector at the device panel, browses the bucket, and selects a document -- OptimiDoc downloads it on demand, converts it to PDF if needed, and prints it as a job owned by that user. It works with Wasabi Hot Cloud Storage and other Amazon S3-compatible services.


Overview

Like the other cloud connectors, Wasabi is a browse-on-demand print source rather than a background watcher. OptimiDoc does not poll the bucket or copy objects automatically. The connector appears in the list of print sources on the device; the user browses the bucket (or a path within it), picks an object, and only then is it downloaded and printed. The object stays in the bucket untouched.

Wasabi is Amazon S3-compatible, so the connector authenticates with an access key and secret key and addresses the storage as a bucket plus an optional path prefix.


How It Works

  1. The user authenticates at an OptimiDoc-enabled device and opens the Wasabi connector.

  2. OptimiDoc connects to the S3 endpoint for the configured region and lists the bucket contents under the configured path.

  3. The user browses and selects one or more objects.

  4. Each object is downloaded on demand and converted to PDF if it is not already.

  5. A print job is created, owned by the signed-in user, and released through the rules engine and quota checks.


Configuration

To configure a Wasabi print connector:

  1. Navigate to Printing > Print Connectors and click Add Connector.

  2. Enter a Name and select Wasabi from the Type dropdown.

  3. On the Configuration tab, complete the settings below.

Configuration Settings

Setting

Description

Access Key

The S3 access key ID for the Wasabi account.

Secret Key

The matching secret access key. Stored encrypted.

Bucket Name

The bucket to browse.

Region

The Wasabi region (e.g. us-east-1). Determines the storage endpoint; leave as us-east-1 if unsure.

Path

Optional path (key prefix) within the bucket to start browsing from.

  1. On the Access Rights tab, assign the connector to one or more Groups.

  2. Click Save.


Regions and Endpoints

OptimiDoc derives the S3 endpoint from the Region: us-east-1 uses https://s3.wasabisys.com, while other regions use https://s3.<region>.wasabisys.com. Make sure the region matches where the bucket was created, or listing will fail.


Troubleshooting

Issue

Resolution

Access denied

Verify the Access Key and Secret Key and that the keys have read access to the bucket.

Bucket not found

Check the Bucket Name spelling and that the Region matches the bucket's region.

Nothing to browse

Confirm the Path prefix points at objects that exist in the bucket.

A document will not print

Objects that cannot be converted to PDF are skipped. Check the OptimiDoc log for conversion errors.


Related articles