Administration panel¶
A number of monitoring and configuration options are available through the admin panel to administer your instance without needing to open config files on the server.
The admin panel is available to administrator users (see Configure administrators).
User Menu (avatar at the top right) > Administration
or go to https://your-instance.com/admin/
This page repeats the comments present on the admin panels and adds a few clarifications.
General¶
Flush HTTP Cache¶
Force users to download the latest client-side assets (only if your server is in fresh mode).
This includes some configuration changes distributed via /api/config
.
Update user quotas¶
Forcing an update of user storage limits can be done any time, but is only necessary in the event of an error.
Close registration¶
Do not allow any new users to register.
Enable remote embedding¶
Allow documents and media from this instance to be embedded on other websites. This will add an "Embed" option to the Share menu. For security reasons applications that use OnlyOffice (Sheets, Document, Presentation) cannot be embedded even if this setting is active.
Please note that by enabling this settings, you will need to adapt your Nginx configuration file, adding vector:
to pass diagnostic tests.
Admin contact email¶
This email address is displayed on the instance contact page.
This email may be used by the development team, only if Consent to contact is given, to warn of security vulnerabilities or in other cases for example matters affecting public facing instances listed in the directory.
Instance information¶
The following fields are used to describe the instance in the list of public instances:
Instance name (optional, if no name is provided the instance URL is used)
Instance description
Hosting location (country where the instance's encrypted data is hosted)
Bemerkung
This information is used on the instance front page.
User Storage¶
This section is for managing storage limits on the instance.
Bemerkung
The values set in the admin panel override the defaults or modifications made to the configuration files.
Storage Limit¶
Maximum storage limit for CryptDrives (users and teams) when no custom rule is applied.
Apply a custom limit¶
Set custom limits for users by using their public key. You can update or remove an existing limit.
Archive documents¶
Make a document unavailable without deleting it permanently. It will be placed in an ‘archive’ directory and deleted after a few days (configurable in the server configuration file).
Make a document unavailable, for example for moderation in the case where a document with inappropriate/illegal content is reported.
Restore documents¶
Restore a document that had previously been archived.
Check account storage¶
Check the total size of items counted against a user or team’s quota given their public key.
List of custom limits¶
List all the custom storage limits applied to your instance.
Statistics¶
Active connections: Number of active websocket connections (and unique IP addresses connected)
Active pads: Number of unique documents currently being viewed or edited
Open Files: Number of file descriptors currently open on the server
Registered users: Number of users registered on your instance
Disk usage: Amount of storage space consumed by various CryptPad resources
Warnung
The disk usage report can be very resource intensive to run on large instances.
Support¶
To enable the Support mailbox, please see Configure support mailbox.
List of tickets sent by users to the support mailbox. All the administrators can see the messages and their answers. A closed ticket cannot be re-opened. You can only remove (hide) closed tickets, and the removed tickets are still visible by other administrators.
reply to tickets
close tickets
remove closed tickets
Broadcast¶
This section offers different ways of sending notifications to all users on the instance.
Maintenance¶
Plan a maintenance on this instance and notify all users. Limited to one active maintenance at a given time.
Survey¶
Add, update or remove a link to an external survey. Users will receive a notification and the survey will remain available from the user menu.
Broadcast Message¶
Send a message to all users on this instance. All existing and new users will receive it as a notification. Preview messages before sending them with "Preview notification". Preview notifications have a red icon and are visible only to you.
Performance¶
An overview of the total time spent executing various server-side commands.
Network¶
Validate instance configuration¶
CryptPad includes a page which automatically diagnoses common configuration issues and suggests how to correct them if necessary. To visit the page use the Run Diagnostics button or visit https://your.instance/checkup/
.
The rest of this section includes options about how you and your instance communicate, or not, with the CryptPad development team.
Server telemetry¶
Opt-out of daily messages sent from the instance to the development team's server. The purpose of these messages is to count how many third-party instances of CryptPad are in operation and which version of the software they are running. The full content of the messages can be reviewed in CryptPad's server logs.
List my instance in public directories¶
Opt-in to have the instance included in the list of public instances on the CryptPad project site if it is intended for public use.
In addition to this setting being enabled, the following criteria are required in order to have an instance listed:
All diagnostic tests must pass
The version of CryptPad must be up to date within 90 days of the latest release
Instance information must be provided in the General tab
Server telemetry must be enabled
Absence of analytics and third-party trackers
A working backup strategy is in place and has been tested
At least one other person must have access to the infrastructure
Commitment to give users at least 6 months of advance warning in case of shutting down
Bemerkung
The list of public instances is considered an extension of the CryptPad community. As such, the development team reserves the right to remove instances from the list if their administrators or the groups they represent are in breach of the Code of Conduct or for any other reason at their own discretion.
Consent to contact¶
Opt-in to allow the development team to contact the Admin contact email with notifications of serious problems with the software or the instance configuration. Administrator emails are never shared, sold, or used for marketing purposes.
Crowdfunding participation¶
Opt-out of advertizing CryptPad's crowdfunding campaign on the instance.
Instance purpose¶
Indicate the purpose of the instance, this is used to inform the development roadmap.
Bemerkung
Instance purpose is only sent to the development team if Server telemetry is enabled