Skip to content

Latest commit

 

History

History
78 lines (63 loc) · 5.02 KB

before-installing.md

File metadata and controls

78 lines (63 loc) · 5.02 KB

Before installing Cassini

You should not have to install Cassini successfully to discover its prerequisites. This guide is for the person evaluating an installation and the administrator or provider who can configure its services. These are things to verify, not automatic detection results.

New to ExApps, or unsure whether they work here? Follow Is Cassini your first external app?. It takes you through AppAPI's Test deploy and back to Cassini installation. If you already have a working deployment service, reuse it and check the Cassini requirements below.

Identify who can make the changes

Nextcloud administrator access does not necessarily include a host terminal or permission to create services. If someone else manages the server, send them the request below. If you have only a NAS/container console, establish which host actually runs Nextcloud before using host commands.

AIO, Compose and NAS are overlapping descriptions: an AIO deployment can use Compose on a NAS. Identify the Nextcloud installation method, the ExApp execution host and the Talk signaling server separately; they need not be the same machine.

Working calls do not imply recording readiness

Ordinary Nextcloud Talk calls can work peer-to-peer without HPB. Cassini recording requires a separate standalone signaling service with HPB media support (such as Janus) and internal-client authentication. TURN helps connectivity but is not a replacement for HPB or the recording backend. See Talk scalability.

Check eligibility before attempting deployment

Needed Where to check or obtain it Who can resolve it
A Nextcloud version supported by the release Compare Administration → Overview with the release manifest; the current branch requires Nextcloud 33.0.9–35 Nextcloud administrator/provider
AppAPI enabled and a working deployment engine Administration → AppAPI; verify an actual Test deploy completes, not only the connection check Administrator of the deployment engine
A compatible execution host Published Cassini images support Linux amd64 and arm64. Check the host where the ExApp will execute, which can differ from Nextcloud's host. CPU transcription is supported; a GPU is optional Execution-host administrator
Talk HPB with media support and internal-client authentication Talk administration and the signaling service's configuration. A working ordinary Talk call is insufficient evidence Talk/HPB administrator/provider
A route from Talk to the recording backend, and Cassini to Nextcloud/HPB Confirm the intended public and internal addresses, TLS and proxy routing Network/service administrator

For AIO, check what the installed version actually provides and which deploy daemon is registered. Reuse an integrated HaRP service where available; older or custom installations may need migration or separate provisioning. Enabling a component is not proof that the complete network path works. For HaRP, verify /exapps/* routing as described in the recording setup guide. For other deployments, arrange a supported ExApp execution engine and HPB rather than assuming the Nextcloud installation already includes them. For Snap, Podman, Kubernetes or a vendor NAS package, check that deployment's supported integration path. A different occ wrapper alone does not establish ExApp compatibility.

The CPU image runs natively on Linux amd64 and arm64 execution hosts, including 64-bit ARM machines. The optional NVIDIA/CUDA image requires x86_64. The execution host can be separate from Nextcloud; emulation is not required for supported architectures.

Once eligible, follow the installation guide, then use Cassini Operator → Publish pipeline to check credentials, storage, processing, and a real Talk recording. The recording setup guide explains the checks and restart behavior.

Request for the administrator or provider

Copy this text and add the public Nextcloud address separately:

I would like to use Cassini to record and transcribe Nextcloud Talk meetings. Can you confirm whether this instance has a supported Nextcloud version, AppAPI with a working ExApp deployment engine, a Linux amd64 or arm64 execution host, and Talk HPB with media support and internal-client authentication?

Please identify who manages Nextcloud, the deployment engine and the Talk signaling server, and whether you can configure Talk to call Cassini. Please preserve any current recording-backend settings and make changes persistent across restarts. If these capabilities are unavailable, please tell me which can be provided and what installation path you support.

Please enter required credentials directly through the agreed secure configuration process; do not send secrets in this ticket. After installation, I would like help completing Cassini's connection checks and a short Talk test recording with playback confirmation.