Installation Guide
Add SYNTHET to your Discord server and grant the necessary permissions. This guide covers invitation, permissions setup, and health checks.
1Invite SYNTHET to Your Server
Use the official invite link to add SYNTHET to your Discord server. You'll be redirected to Discord's authorization page.
SYNTHET Invite Link:
Invite SYNTHETYou need Manage Server permission on your server to add bots.
2Select Your Server
On Discord's authorization page, select the server where you want to add SYNTHET from the dropdown menu. Only servers where you have the required permissions will appear.
What if I don't see my server?
Make sure you're logged into the correct Discord account. Only accounts with Manage Server permission will see the server in the dropdown.
Creating a new server?
If you're on a new server, wait a moment for Discord to sync permissions, then refresh the page and try again.
3Authorize Required Permissions
Review the requested permissions. SYNTHET requests Administrator permission by default for convenience, but you can customize individual permissions in your server settings after installation.
Essential Permissions Explained
Send Messages
Core feature - allows SYNTHET to respond to commands and send notifications
Manage Roles
For auto-roles, role rewards, leveling, and reputation systems
Ban/Kick Members
For moderation actions like banning, kicking, and infractions
Manage Messages
For auto-moderation, message purging, and message reactions
Manage Channels
For ticket system, temporary channels, and channel creation
View Audit Log
For advanced logging and security tracking (optional)
Tip: SYNTHET works best with Administrator permission, but if you prefer minimal permissions, use the custom permissions option after approval.
4Complete the Authorization
Click the "Authorize" button to complete the installation. SYNTHET will be added to your server immediately.
SYNTHET is now on your server! You'll see it in your member list. Next, run /setup to configure it.
Recommended Channel Structure
For the best experience, create these channels for SYNTHET to use:
#mod-logs (Private - Admin Only)
For moderation action logs: warns, kicks, bans, mutes. Keep this private for safety.
#server-logs (Private - Admin/Mods Only)
For general server events: member joins/leaves, message edits, role changes. Useful for auditing.
#welcome (Public)
Where SYNTHET posts welcome messages for new members. Great first impression!
#general or #bot-commands (Public)
For members to interact with SYNTHET commands like leveling checks, fun commands, etc.
Fine-Tuning Permissions After Installation
After inviting SYNTHET, you can adjust its permissions in your server settings for more control.
→Go to Server Settings
Server Settings → Roles (find SYNTHET's role)
→Adjust Role Permissions
Toggle individual permissions on/off. Only enable what SYNTHET needs for your enabled modules.
→Role Hierarchy
Drag SYNTHET's role above the roles it needs to manage (e.g., above muted role, above member roles for leveling rewards)
→Channel-Specific Permissions
Set channel-specific permissions if you want SYNTHET to work differently in different channels
Bot Health Check
Verify that SYNTHET is working correctly with this simple test:
Run the Ping Command
In any channel, run:
/pingSYNTHET should respond with latency information. This confirms the bot is responsive and connected.
Check Server Logs
Look for a message in the #server-logs channel (if you've set one) showing SYNTHET joined. This confirms logging is working.
Review Slash Commands
Type "/" in any channel and look for SYNTHET commands. If they appear, slash command registration is complete.
Troubleshooting Installation
SYNTHET doesn't appear in the server
Check your Member List → App integrations or scroll to find SYNTHET. If it's not there, try inviting again with the link. Make sure you authorized the correct server.
Slash commands not showing up
Slash commands can take up to 1 hour to register globally. Try: 1) Refreshing Discord (Ctrl+R), 2) Waiting a few minutes, 3) Restarting your Discord client. If still missing after 1 hour, check permissions.
Permission errors when using commands
Make sure SYNTHET's role is positioned above other roles in the hierarchy (Server Settings → Roles). Check channel-specific permissions and ensure SYNTHET has the required permissions there.
"Authorize" button not working
Clear your browser cookies and cache, then try again. Make sure pop-ups are enabled. Try a different browser if the issue persists. You may also need to be logged into Discord.
"You don't have permission to do this"
You need Manage Server permission to invite bots. Contact your server administrator if you don't have this permission.
What's Next?
SYNTHET is now installed! The next step is to configure it for your server:
Proceed to First Setup Guide