Admin guide for organization licenses

1. You buy a license, and we email the license key (DLK-…) to the purchase email address.
2. A Nextcloud admin binds the license to the server address in the Deckloud app or on the manage page.
3. Each app reads its user ID and groups from your server and reports its user to api.deckloud.com as a seat hash. On a licensed server, it verifies the signed license token it receives on the device.

The security page lists everything the apps send.

• Nextcloud with the Nextcloud Deck app, and an account in its admin group.
• Users on the current Deckloud for iPhone and iPad, Android, or desktop (Mac with Apple Silicon, Windows 11, Linux).
• License key: the manage page, Deckloud for desktop, or the Android app. The iPhone and iPad apps only show the license status.
• The status without the key needs the server reachable from the internet over HTTPS. Other servers use the key; see server_unreachable.
• Devices need HTTPS access to api.deckloud.com, or an offline license.

Choose the number of users on the organizations page and pay by card on Polar. Polar issues a VAT invoice, and we email the license key to the purchase email address.

To skip pasting the key, verify as the server's admin first: on the manage page, enter the server address users sign in to and select Verify as server administrator, or in Deckloud for desktop open Settings > Account > For teams and select Verify in browser. If you pay within an hour of verifying, the checkout you start there binds this server as soon as the payment goes through; otherwise activate the key from the email.

api.deckloud.com checks the admin group through Nextcloud Login Flow v2, then has Nextcloud delete the app password, retrying for up to 30 days.

After you buy a license on the organizations page, activate the key from the email in one of two places:

• On the manage page: enter the server address and the key, then select Activate the key for this server.
• In Deckloud for desktop, signed in as an admin: open Settings > Account > For teams, paste the key and select Activate for this server.

Keep the key email: the key is never shown again, and only it adds servers and opens the Polar customer portal.

The manage page and Settings > Account > For teams show the license status. Your rights depend on how you open the license:

An admin verification lasts 1 hour.

Users do nothing beyond signing in as usual. Settings > Account > For teams then shows that your organization provides Pro on this server.

Organization Pro applies only while the account on your server is the active one in Deckloud. Other accounts on the device, such as a personal one, do not get it. Personal Pro purchases stay valid.

Apps check the license regularly. Check again under For teams checks right away.

A license is bound to the exact server address users enter in Deckloud. A Business license binds up to 2 servers, such as production and staging. Provider licenses have no server limit; see the provider plan.

A second address for the same server counts as another server, so bind it too. Each address belongs to one active license at a time.

Add the new address with the key, then remove the old one on the manage page. Users on the old address return to Free at their next license check; nothing is deleted.

By default, every user of your servers gets Pro. To limit it, enter a group ID (not its display name) under Nextcloud group, in the app or on the manage page.

Apps check membership on the device with the user's Nextcloud groups; Deckloud knows only the group ID. Changing the group restarts the count of reported users, and users outside it see not_in_group.

Switch on Turn off usage analytics in the app or on the manage page. Apps with the license token then send no usage analytics and show the setting as managed. Users outside the licensed group get no token; use the MDM key analytics for them. Details: security page.

The terms require one seat for each person who uses Deckloud on the license's servers. One Nextcloud user ID on production and staging needs one seat. Accounts that never use Deckloud need none.

Next to the seats, the manage page and the app show the users reported in the last 30 days. You see them with the key. A user drops out after 30 days without use, such as a disabled account.

Deckloud cannot verify these reports without access to your server, so the count is information only and never removes Pro. Above the seat count, you see over_limit.

Cancel in the Polar customer portal. The license stays active until the end of the paid period; then the license and its tokens end, and apps return to Free.

After a refund or revocation, apps return to Free at their next license check or when their token expires. Returning to Free deletes nothing, and users who bought Pro themselves keep it.

Request a new key on the license recovery page with the order email and order ID; we email it to the purchase address. The old key stops working, and servers already bound keep the license.

The Deckloud app and the manage page show these messages.

No license has this key. Check for typos: a key starts with DLK- and has 5 groups of 5 characters. After a recovery, only the new key works; recover a key if needed.

The subscription has ended or was not paid. Check it in the Polar customer portal, and try again after payment.

The license was refunded or revoked. Apps return to Free at their next license check, and nothing is deleted. If this is a mistake, email partners@deckloud.com with your order ID.

A Business license binds up to 2 servers. Remove one you no longer need on the manage page, then add the new one.

This address is already bound to another active license. Verify as the server administrator on the manage page, remove that license, then activate your key.

Many networks use this address: a private IP address, a single-label or generic local name such as nextcloud.local, or a Deckloud server. A key does not bind it, since the license would reach every server with that address. Give users your server's own name, or email partners@deckloud.com if it has none.

Activating the key would end the trial on this server, which only its admin may do. Verify as its admin on the same screen; the key then takes over the trial, and users keep Pro.

A trial stays on the server that started it until it ends and cannot be removed. Activate a bought key for that server to take over the trial.

Deckloud no longer offers trials, and older app versions show this message when you try to start one. Buy a license and activate it; users keep their data.

The account you signed in with in the browser is not in the Nextcloud admin group. Use an admin account, or ask an admin to add you.

The admin verification needs the server at a public HTTPS address. Check the address, TLS certificate and firewall. For a server reachable only inside your network, activate the license with its key. For private IP addresses and local names, see origin_shared.

Enter the server address as users enter it in Deckloud, for example https://cloud.example.com.

The admin verification lasts 1 hour, and some actions need the key. Verify again, or open the license with the key.

No license is bound to this address, or the order was not found. Check that it is the address users enter in Deckloud, then activate a key or buy a license.

api.deckloud.com rejected the request, for example because a field was missing. Update Deckloud and try again.

This network or license key sent too many requests. Wait an hour and try again.

api.deckloud.com is down, in maintenance, or not accepting new verifications. Try again later. Devices keep Pro until their token expires, at most 30 days.

The device could not reach api.deckloud.com. Check the connection, proxy and firewall. Devices keep Pro until their token expires, at most 30 days after the last successful check.

Nextcloud rejected the account's app password or asked Deckloud to slow down, so Deckloud paused all its requests, the license check included. Sign in again, or try again in a few minutes.

Polar could not charge the last renewal and retries the payment. Update the payment method in the Polar customer portal. The license stays active for 7 days after the paid period ends.

The license ends within 14 days and does not renew, usually after a cancellation. Resume the subscription in the Polar customer portal to keep Pro.

The apps reported more users in the last 30 days than the license has seats. Everyone keeps Pro, but the terms require more seats. Add them in the Polar customer portal, or limit the license to a group.

The trial ends within 7 days. Buy a license and activate its key for the server so users keep Pro without a break.

Deckloud found no active license for this server address. Activate a key or buy a license. Apps ask again after 24 hours, or when the user selects Check again.

The license is limited to a Nextcloud group this user is not in. Add the user, choose another group or remove the limit; the app sees it at its next license check.

Email partners@deckloud.com in English or German, with the server address and the license ID from the manage page. We answer within 2 business days, with no SLA and no phone support.