Getting Started
Welcome to the official Aetheria setup documentation. Aetheria is a modular, high-performance administrative Discord bot designed to manage moderation, levels, support ticketing, and layout backups with ease.
Quick Setup Guide
Invite the Bot
Add Aetheria to your Discord guild using the OAuth2 invite link. Make sure you are logged into your Discord account and have the Manage Server permission on the target guild.
Open the Web Dashboard
Visit the web dashboard. Log in securely using your Discord account via NextAuth, and select your guild from the active server grid.
Toggle and Configure Modules
Customize welcome & goodbye templates, set up moderation rules, establish leveling role rewards, and deploy the support ticket panel.
Recommended Permissions
To operate efficiently and perform administrative tasks, Aetheria requires a set of specific permission flags. While giving the bot the Administrator permission is the simplest and recommended method, you can also grant only the necessary permissions:
Self-Hosting Configurations
If self-hosting Aetheria, configure these environment variables in your root .env file:
| Variable | Description | Example |
|---|---|---|
| DISCORD_TOKEN | Private token of your Discord Application Bot. | MTUxMjIy... |
| DISCORD_CLIENT_ID | Client application ID of your bot. | 1512220080346501150 |
| API_SECRET | Authorization key for bot↔dashboard requests. | super_secret_token_987... |
| DATABASE_POSTGRES_PRISMA_URL | Prisma SQLite path URL. | file:./prisma/dev.db |