SpipCP
Administration

Settings

Panel-wide configuration โ€” email, encrypted secrets, git accounts, locality, and the audit log. Admin-only.

Settings is the admin area for panel-wide configuration โ€” a set of pages in the sidebar, each covered below.

The Settings area
๐Ÿ“ทSettings โ†’ the admin configuration pages.img/settings.avif
Settings โ†’ the admin configuration pages.

Email

Configure the SMTP server SpipCP uses to send invites, password resets, and monitoring alerts. Email settings are stored encrypted, and login never depends on email โ€” so a broken mailer can't lock anyone out.

Email settings
๐Ÿ“ทEmail โ€” SMTP host, credentials, and a test send.img/settings-email.avif
Email โ€” SMTP host, credentials, and a test send.

โ†’ Detail: Setup wizard.

DNS providers

Named DNS credentials โ€” Cloudflare, Bunny, Hetzner, deSEC, or Gcore โ€” that let SpipCP create DNS records automatically when a domain is attached. The API token is encrypted and never reaches a node, and an account can be set as a default that cascades node โ†’ instance โ†’ domain. To run self-hosted nameservers instead, see the DNS section.

โ†’ Full page: DNS providers.

SSL issuers

Alternative certificate authorities for HTTPS โ€” ZeroSSL or Actalis (ACME with EAB) and self-supplied custom certificates. Let's Encrypt is the default and needs no account. Secrets (EAB HMAC keys, private keys) are encrypted and never reach a node; the chosen issuer cascades node โ†’ instance โ†’ domain.

โ†’ Full page: SSL issuer accounts.

Secrets

The encrypted secret store. Secrets are kept encrypted, and revealing one is audited, so there's a record of every time a secret was viewed.

Secrets settings
๐Ÿ“ทSecrets โ€” the encrypted store, with audited reveal.img/settings-secrets.avif
Secrets โ€” the encrypted store, with audited reveal.

Git accounts

Reusable provider credentials (GitHub, GitLab, Bitbucket, Gitea) used to browse repos and register deploy keys. The token stays in the panel and never reaches a node.

โ†’ Full page: Git accounts.

Locality

The panel's default timezone and locale, plus per-user overrides โ€” so timestamps and formats read the way each person expects.

Locality settings
๐Ÿ“ทLocality โ€” timezone and locale, panel default and per-user.img/settings-locality.avif
Locality โ€” timezone and locale, panel default and per-user.

โ†’ Detail: Locality.

Changelog

Not a Settings page but its own item in the Admin group: where a release is written โ€” version, severity, summary, and items tagged new / improved / fixed โ€” saved as a draft and published in one click. A draft is invisible everywhere until published. Publishing can notify users in-app and by email (each user can turn release email off in their own preferences; it is on by default), and POSTs a signed webhook to anything listening.

Composing a release
๐Ÿ“ทCompose a release โ€” version, severity, and the items. The commits baked into the image are offered as a starting point, to be reworded.img/changelog-compose.avif
Compose a release โ€” version, severity, and the items. The commits baked into the image are offered as a starting point, to be reworded.

Delivery is configured on Settings โ†’ Changelog: the webhook endpoints that get every published release (signed with HMAC-SHA256, the same scheme as the probe webhooks), and mirror mode โ€” pointing the panel at a canonical feed makes it render that changelog instead of its own blank one. Mirroring is off by default, and off means no outbound request at all.

Changelog settings
๐Ÿ“ทSettings โ†’ Changelog โ€” signed webhooks, and mirroring a canonical feed.img/settings-changelog.avif
Settings โ†’ Changelog โ€” signed webhooks, and mirroring a canonical feed.
PermissionGrants
changelog:viewRead the releases and the "what's new" panel. Held by operators.
changelog:manageWrite, publish, unpublish, delete a release (admin-only).

Published releases become the public feed the docs changelog renders.

โ†’ Consume it: Changelog API. ยท What the numbers mean: Versioning.

Audit log

The append-only record of accountable actions โ€” who did what, when. Also reachable from Activity in the sidebar.

โ†’ Full page: Audit log.

Admin only

Settings is admin-only. Operators don't see it in their navigation, and the server refuses the underlying calls either way โ€” hiding the menu is just a convenience on top of that.

On this page