Skip to main content
Skip table of contents


Services are software agents in SAFEQ Cloud that manage the workflow of the document process, for example, authentication, printing, or document storage.

Adding and removing multiple services to/from a server

You can add or remove multiple services from the SAFEQ Cloud system under a server node in the system tree. When a service is placed under a server node in the tree, it is owned by that parent node and will inherit any security and access control permissions granted to the parent.

  1. To add and remove multiple services, click Create new > Services or click Add multiple.

  2. The Service information screen will be displayed. It contains the following elements:
    1. Server – The server where you are adding services or removing them.
    2. Available – This column contains all the services not yet running on the selected server.
    3. Selected – This column contains all the services already running on the selected server.
  3. Click SAVE to save your changes.
A service can also be added directly to a server in the Server > Services group, see Settings section.

Service information settings

When adding a service, specify the following, to determine the service role, the host server, and other settings:

  1. Name – User-friendly name of the service as it appears in the SAFEQ Cloud navigation tree.
  2. Type – Choose service type. See the table in section List of available services in SAFEQ Cloud for the available types.
  3. Use Separate JVM – Select this option to run the service within its own JVM on the target server. Running the service within its own JVM instance eliminates potential Java class or system resource conflicts and ensures that the service does not affect any existing services or the main application. It can be useful if you need:

    • to constrain the resources (CPU and memory) consumed by a service
    • to monitor the behavior of each service instance

      Be aware that enabling separate JVM mode has higher requirements on the hardware; in particular, more RAM is typically needed.

  4. Enabled – Controls whether the service is active or not.
  5. Location – This value indicates the service location. If no location is set in the service, it will retrieve and display the inherited location of the parent (Account).
  6. Server – Select the target server or servers where the service should run. The service will be hosted on the selected server(s) after it is created. Only servers that exist on the same branch within the SAFEQ Cloud system tree will be displayed.

    Some services can run only on a single server (such as Storage), while others (such as Document Output service) can run on multiple servers. This is useful for load balancing a service across multiple servers and providing redundancy for a service, so if one server goes down, the service will continue to run on the other server.

Click SAVE to create and run the service on the target server(s).

Note you may only host one instance of a service type on the same server.

The list of available services in SAFEQ Cloud

Service typeDescription
APIA service used to programmatically interact with SAFEQ Cloud, for example, from external applications, automation scripts, etc.
AuthenticationA service that communicates with AD/LDAP directories, Microsoft Entra ID, and similar to authenticate users.
ConversionA service responsible for converting or preparing documents in one format to another, for example, converting a Word document to PDF.
Document OutputA service responsible for delivering print job data to printers or MFDs.
IPPA service that receives print job data from SAFEQ Cloud clients (Windows, Mac, and Linux).
MobileA service handling communication from Y Soft Apps, MDM solutions, Wide Area Mobile Print DNS communication, etc.
StorageA service responsible for transferring and storing documents.
Terminal ClientA service that deploys embedded terminal clients running inside MFDs, and the service with which MFDs communicate for authentication, retrieving jobs and other purposes.
MessageA service is responsible for delivering messages, such as emails, from SAFEQ Cloud to external systems, such as email SMTP servers.

Editing a Service

Edit a Service by clicking the Service name within the SAFEQ Cloud System tree and clicking Service information.

You can also manage services in the Services menu of the host server. Click the edit or delete icon in the list to edit or delete the service from SAFEQ Cloud.

Limiting Request rate

To minimize the denial of service attack possibility, the API and IPP services can be configured to limit the number of requests per second from a given IP address. You can modify this in the service configuration screen:

If the number of requests exceeds the given limit, the client will receive HTTP error 425.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.