Skip to main content
Skip table of contents

Installing SAFEQ Cloud Client on macOS

SAFEQ Cloud Client installer can be downloaded from SAFEQ Cloud Web UI.

SAFEQ Cloud Client can be installed in two ways:

  • Quick installation – preconfigured installation without the possibility to change configuration after installation
  • Advanced installation – installation with the possibility to change the configuration after installation

For general requirements and prerequisites, see System requirements.

Quick installation

Limitations

  • The client can not be installed in local storage mode.
  • The Client is installed with the SAFEQ Cloud OAuth2 login authentication type.
  • Once the Client is installed, the Configuration option is removed from the menu.

Do the following to install SAFEQ Cloud Client using the quick installation type:

  1. Log in to your Web UI, navigate to My profile, and click MacOS.
  2. Run the installation file.
  3. On the welcome screen, click Continue.

  4. On the next screen, read the license agreement and click Continue. A pop-up screen will appear.
  5. On the pop-up screen, click Agree.
  6. On the Installation Type screen, click Install.
  7. Authorize the installation, wait until the SAFEQ Cloud Client is installed, and then click Close.

  8. Log in on the login screen opened in your web browser.
  9. The application starts automatically.

Advanced installation

Do the following to install SAFEQ Cloud Client using the advanced installation type: 

  1. Log in to your Web UI, navigate to My profile, and click MacOS.
  2. Modify the installer name so it does not contain your domain name in square brackets. Example: safeq-cloud-client-x.x.x-setup[acme.eu.ysoft.cloud].pkg -> safeq-cloud-client-x.x.x-setup.pkg

    If you keep the square brackets in the name of the installer, the installer will default to quick installation and you will not be able to configure the SAFEQ Cloud Client after installation.

  3. Run the renamed installation file.
  4. On the welcome screen, click Continue.

  5. On the next screen, read the license agreement and click Continue. A pop-up screen will appear.
  6. On the pop-up screen, click Agree.
  7. On the Installation Type screen, click Install.
  8. Authorize the installation, wait until the SAFEQ Cloud Client is installed, and then click Close.
  9. The application will start automatically.

  10. Click the SAFEQ Cloud Client icon. In the menu, select Configuration.


  11. On the configuration screen, click Service setup and enter your password for the privilege elevation.
  12. On the Service configuration screen, set your custom configuration, and then click Register service.


    • Server host name – address or host name of the SAFEQ Cloud server to connect to. For “Local storage mode” the address should be the DNS of the SAFEQ Cloud primary server.
    • Account domain name – domain name of the target account. It can be found in SAFEQ Cloud Web UI on the Customer information tab.
    • Authentication type – select user authentication type.
    • API key – API key from the account settings. If omitted the default (restricted) API key will be used. Default API key will be removed in the future product versions.
    • Allow local document storage and print job delivery – enable local storage operation mode.
  13. After the configuration, users can log in.

Unattended installation

You can also use this guide to push the SAFEQ Cloud Client to Mac devices using tools like jamf or Workspace ONE.
For further information, you can refer to these Jamf guides:

Download this sample .plist file to update it with the desired SAFEQ Cloud Client configuration parameters. Make sure the file is named as com.ysoft.safeqclient.plist

Below is a description of each of the parameters:

  • accountDomain – account domain name
  • authType – User authentication type: 0 = session user, 1 = custom login, 2 = Microsoft Entra OAuth2, 5 = OpenID Connect, 6=SAFEQ Cloud OAuth2 login
  • gatewayAddress – SAFEQ Cloud gateway address
  • loginPopupType – specify the type of the login popup: 0=no popup, 1=informational bubble, 2=dialog
  • refreshPeriod – automatic synchronization period in minutes.
  • allowLocalStorage – true = turn on, false = turn off local storage mode of SAFEQ Cloud Client. In this mode, the jobs will be stored on a Mac. This mode requires SAFEQ Cloud Client registration and authorization on SAFEQ Cloud server.
  • storageType – 0 = send jobs to gateway, 1 = store jobs locally. This option is only applicable when local storage mode is activated. It corresponds to the tray menu item which can select the job destination.
  • allowConfiguration – true = enable configuration menu item, false = disable configuration menu item.
  • allowRememberLogin – true = show the “Remember login” option when showing a prompt to enter a custom username and password, false = do not show this option.
  • directOfflinePrint – true = enable direct offline printing
  • apiKey – custom API key to use instead of the default one.
  • offline – if set to true, it will install the SAFEQ Cloud Client in offline mode, without registration or server connectivity check. See this section for details.

Example of a .plist file:

CODE
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>accountDomain</key>
	<string>
acme.local</string>
	<key>authType</key>
	<integer>1</integer>
	<key>gatewayAddress</key>
	<string>server.acme.local</string>
	<key>loginPopupType</key>
	<integer>2</integer> 
	<key>refreshPeriod</key>
	<integer>60</integer>
	<key>allowLocalStorage</key>
	<false/> 
	<key>offline</key>
	<true/> 
</dict>
</plist>

Jamf best practices

For Jamf deployment, it is recommended to use a script that runs before the pkg file is installed and copies the .plist file to the proper location.

SAFEQ Cloud Client supports two locations for the .plist file: /Library/Preferences and /Library/Managed Preferences. The latter can be used by Jamf deployment tool to deploy the preferences automatically without the custom script.

Script example:

CODE
#!/bin/bash
PLIST=/Library/Preferences/com.ysoft.safeqclient.plist
cat << EOF >$PLIST
[xml plist content]
EOF
defaults read $PLIST



Replace [xml plist context] with the actual .plist file.

Steps for silent installation

You can also copy the .plist file to /Library/Preferences if the configuration is to be shared by all users. This requires a restart of Mac devices or running the defaults read /Library/Preferences/com.ysoft.safeqclient.plist command.

1. Copy the updated .plist file at /Users/[username]/Library/Preferences on Mac device

BASH
sudo cp <from path> /Library/Preferences

2. Install SAFEQ Cloud Client

BASH
sudo installer -pkg safeqclient-3.15.0-release-setup.pkg -target / 
sudo installer -store -pkg safeqclient-3.15.0-release-setup.pkg -target /

3. Uninstall SAFEQ Cloud Client

BASH
sudo /Applications/safeqclient.app/Contents/MacOS/uninstall

JavaScript errors detected

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

If this problem persists, please contact our support.