Atlas project production

Mailbox Restore and Archive Import Utility

Restores MBOX/EML archives into Google Workspace accounts during mailbox recovery or migration events.

Internal-only entry. Do not publish externally without review.

Type: System
Lifecycle: Active
Last touched: 2026-03-24
Visibility: Internal

Purpose

Restores MBOX/EML archives into Google Workspace accounts during mailbox recovery or migration events.

Current state

Aether includes `mbox-restore.sh` (GYB-backed restore) and related configuration scaffolding, providing a repeatable path to import mail archives into target accounts with labeling and batching controls. Current registry state: Supported Helper Workflow / Active / Medium. Email data recovery and migration support. Trigger / frequency: on-demand recovery or migration..

Next step

confirm approved retention workflow and legal hold handling. Yes - confirm legal/compliance approval flow and archival retention policies.

Interfaces

Inputs

MBOX/MBX/EML archives.

Outputs

Google Workspace mailboxes with restore labels.

Reality to Action trace

Reality Ingestion

Contributes in this stage.

Canonical Storage

Not in scope.

Automation Engines

Not in scope.

Human Interfaces

Not in scope.

Operational Adoption

Not in scope.

Core workflow

TBD. Document the 5-10 steps that define the core workflow.

Data integrity and contracts

Source of truth rules

MBOX/MBX/EML archives. remain the authoritative upstream inputs for this workflow.
Google Workspace mailboxes with restore labels. should be treated as downstream copies, recipients, or operational consumers rather than the authoring system.

Safe handling

Protect credentials, generated files, logs, and any transient export artifacts.
Treat student identifiers, rosters, and related records as FERPA-restricted data.
Limit staff identity, employment, or account data to approved administrators and business owners.

Operational notes

Reliability posture

GYB output provides run logs; centralized monitoring is not documented. Failure impact: delayed mailbox recovery and compliance risk. Manual fallback: manual Vault export/import processes..

Observability

GYB output provides run logs; centralized monitoring is not documented.
Failure impact: delayed mailbox recovery and compliance risk..
Manual fallback: manual Vault export/import processes..

Security and privacy

service-account access and mailbox delegation. Classification: confidential email content. mailbox contents are sensitive and should follow retention and access policies.

Dependencies

Upstream

GYB tool availability, service-account permissions, and archive integrity.

Downstream

Google Workspace mailboxes with restore labels.

Ownership

Owners

Technology Services

Users

Technology Services, Technology Services / HR or legal stakeholders depending on request

Mailbox Restore and Archive Import Utility

Operational Notes

Method: MBOX import using GYB with service-account authorization.
Implementation: mbox-restore.sh, bin/gyb, config/gyb.conf.example, and data/mbox-import/ staging.
Trigger / frequency: on-demand recovery or migration.
Failure impact / fallback: delayed mailbox recovery and compliance risk. Manual fallback: manual Vault export/import processes..
Related references: mbox-restore.sh.

Registry Alignment

Mapped registry entry: INT-074
Registry clarified: Aether includes mbox-restore.sh (GYB-backed restore) and related configuration scaffolding, providing a repeatable path to import mail archives into target accounts with labeling and batching controls.
Validation gaps: confirm approved retention workflow and legal hold handling.