Skip to main content

Logo Grist

About

Grist is a modern relational spreadsheet.

Admin access

Grist does not expose an admin role through the Cloudron user interface. Grant admin privileges by setting GRIST_DEFAULT_EMAIL to the email address of the admin user in /app/data/env.sh using the File manager.

Bash
export [email protected]

Restart the app after making changes. The user signs in with the matching email address and gains access to the admin panel.

Single Sign-On

The package wires Grist to the Cloudron identity provider automatically. No configuration is required — users sign in with their Cloudron account via OIDC.

SSO is a full edition feature

With grist-core 1.7.18, Grist Labs stopped officially supporting OIDC/SAML outside the full edition of Grist. Installations configured before that change are expected to keep working, and SSO does still work in this package as of upstream 1.7.18. Future upstream releases may restrict or remove it without notice.

If SSO matters for your deployment, get a full edition activation key. Grist Labs hands these out for free, valid for one year, see the free activation key FAQ. Set the key in /app/data/env.sh using the File manager and restart the app, or enter it on the Installation page of the Grist admin panel.

Bash
export GRIST_ACTIVATION=<your-activation-key>

Custom config

Set custom environment variables in /app/data/env.sh using the File manager.

Bash
export GRIST_DEFAULT_LOCALE=de

Restart the app after making any changes.