Administration guide
Browse by topic
Discover Administration guide
Explore related documentation through its most useful keyword groups.
31 items
Grouped by Domain
Configuration
10 itemsDefining site module runtime and service settings.
- Change persistent configuration
- Check or change a site database connection
- Configure hostnames and HTTPS
Site management
8 itemsCreating configuring updating starting and stopping Zotonic sites.
- Choose the site admin or the status site
- Configure service startup and restart behaviour
- Deploy and verify a release
Authorization and access control
6 itemsDetermining which users may view change or administer resources and operations.
- Assign user groups and check access
- Choose the site admin or the status site
- Remove access when someone leaves
Logging and monitoring
5 itemsRecording and observing events errors state health and performance.
- Check that a site is working
- Diagnose failed uploads or missing media
- Diagnose missing or failed email
Backup and restore
4 itemsPreserving and recovering site data media and configuration.
- Create and check a site backup
- Define what a complete backup includes
- Recover one page without restoring the whole site
Media management
3 itemsManaging files and media resources throughout their lifecycle.
- Configure and check persistent media storage
- Configure media sandboxing and an optional media runner
- Diagnose failed uploads or missing media
Identity and accounts
3 itemsManaging users login identities account data and account lifecycle.
- Assign user groups and check access
- Remove access when someone leaves
- Review accounts and shared responsibilities
Email delivery
3 itemsSending queuing relaying and tracking outgoing email.
- Configure outbound email and verify delivery
- Diagnose missing or failed email
- Direct test mail to a controlled recipient
File storage
2 itemsPersisting media previews archives and other managed files locally or remotely.
Explore this clusterOther
2 itemsDocumentation not covered by the other keyword groups in this split.
Explore this clusterAll Administration guide
Add a language and choose its availability
Prepare translations before making a language visible to visitors.
Assign user groups and check access
Give an account the permissions required for its work.
Change persistent configuration
Choose the right configuration layer and verify the effective value.
Check or change a site database connection
Verify host, role, database, and schema before restarting a site.
Check that a site is working
Monitor the user-facing service as well as its processes.
Choose the site admin or the status site
Use the right management surface and account.
Configure and check persistent media storage
Keep original uploads accessible across deployments and restarts.
Configure hostnames and HTTPS
Align DNS, site selection, and certificate termination.
Configure media sandboxing and an optional media runner
Check media-process isolation and decide whether to run conversions on a separate service.
Configure outbound email and verify delivery
Set a relay at the correct scope and test a real site message.
Configure service startup and restart behaviour
Run Zotonic under the installation’s service manager.
Create and check a site backup
Request a backup and verify its completion and scope.
Define what a complete backup includes
Choose recovery coverage, retention, and an owner.
Deploy and verify a release
Apply a tested revision and check the site from a visitor’s perspective.
Diagnose a site that will not start
Separate node, site, database, and application failures.
Diagnose failed uploads or missing media
Locate the failure in permission, storage, or processing.
Diagnose missing or failed email
Trace one message from request to recipient.
Direct test mail to a controlled recipient
Prevent an acceptance workflow from emailing real users.
Enable or disable a site feature
Change module activation and verify the affected workflow.
Hand over an incident and record recovery
Give the next operator enough context to continue safely.
Plan and apply an upgrade
Test version-specific changes and establish a recovery point.
Prepare an acceptance or production environment
Separate environments and record how the site is operated.
Prepare and carry out recovery from a failed release
Recover code and data to a compatible state.
Read logs and collect useful evidence
Find the relevant failure without exposing credentials or personal data.
Recover one page without restoring the whole site
Use revisions or deleted-page recovery for an editorial mistake.
Rehearse a complete site restore
Restore into isolation and verify content, media, and access.
Remove access when someone leaves
Remove login methods and permissions without deleting their authored content.
Review accounts and shared responsibilities
Find obsolete access and verify who can administer the site.
Run a planned maintenance window
Coordinate changes and verify service before reopening access.
Set upload sizes and allowed file types
Adjust group upload limits and test with an ordinary account.
Test and publish access rules
Check a rule change before it affects everyone.