Aetheria Documentation

Server Backups

Aetheria provides server configuration snapshotting. Backup your channel layouts, role permissions, and categories, then restore them in a single click in case of emergency or reorganization.

What Gets Backed Up

Aetheria snapshots the entire structural layout of your server. This includes:

  • Roles: Role name, color, hoist (separated in list), permissions bitfield, and relative hierarchy position.
  • Categories: Category channel names, positions, and specific role overwrites.
  • Text & Voice Channels: Channel names, types, positions, topics, NSFW settings, slowmode rates, and sync permissions with category.
  • Permission Overwrites: Detailed user and role permission overrides mapped to individual channels.
Note: Due to Discord's privacy and API limitations, backups do not archive messages, user avatars, guild emojis, stickers, or webhooks.

Creating a Backup

Creating a snapshot of your server is simple and can be done entirely through the web panel:

  1. Navigate to Server Backups under the Support group in the dashboard.
  2. Click the "Create Backup" button at the top right.
  3. Aetheria will gather all server channels and roles from Discord and generate a new snapshot.
  4. The snapshot will appear in your backups table, displaying the backup ID, creation date, channel count, and role count.

Restoring a Backup

If you need to revert your server to a previous state, you can trigger a restore:

  1. Find the desired snapshot in the backups table.
  2. Click the "Restore" button next to it.
  3. A confirmation prompt will appear, outlining the actions about to be taken.
  4. Type or confirm the authorization request to begin the restoration sequence.

Critical Restoration Warning

The restoration process is extremely destructive. Please read and understand these implications before proceeding:

  • Channel Deletion: All existing text and voice channels will be deleted to allow the bot to recreate the exact category and channel layout from the backup.
  • Role Deletion: Roles that existed at backup time will be deleted and re-created. Custom roles created after the backup will remain but may lose their channel permission overrides.
  • Bot Permission Hierarchy: For roles to be deleted and recreated, the Aetheria bot's integration role must be positioned at the top of the Discord roles list. The bot cannot manage or delete roles that are higher than itself.