📚 Glyte Bot Docs

Glyte Bot — Setup Guide

Everything you need to install, configure, and self-host Glyte Bot for your Discord server. Commands, troubleshooting, and deployment docs all in one place.

1. Overview

Open SourceDockerDiscord.pyMongoDB Atlas

Glyte Bot is a modular Discord bot built for communities, teams, and servers that want built-in attendance tracking, gamification, coins, quests, shop, moderation, and a live dashboard. It runs as a Docker container and stores data in MongoDB Atlas.

2. Features

✅ Daily Check-ins

Track member attendance, calculate streaks, and reward consistency.

🎮 Gamification

XP, levels, quests, and role rewards keep engagement high.

🪙 Coins & Shop

Members earn coins for activity and spend them on custom rewards.

📊 Live Dashboard

View overview stats, leaderboards, attendance, leaves, and insights.

🛡️ Moderation

Moderation tools to manage your community.

🚀 Easy Self-Hosting

Docker Compose, environment-based config, and clear setup docs.

3. Create the Discord Bot

Open the Discord Developer Portal.
Click New Application and give it a name.
Go to the Bot tab and click Add Bot.
Under Privileged Gateway Intents, enable Server Members Intent and Message Content Intent.
Copy the bot token under the Token section and keep it secret.

4. Create MongoDB Atlas

Glyte Bot uses MongoDB Atlas, not a local MongoDB server.

Create a free-tier cluster at MongoDB Atlas.
Create a database user with read/write access.
Allow access from 0.0.0.0/0 for the VPS IP or use Atlas network access rules.
Copy the SRV connection string from Database > Connect.

5. Install with Docker

git clone https://github.com/Buriatma/attendance-discord-bot.git
cd attendance-discord-bot
cp .env.example .env
docker compose up -d --build

After the build completes, the bot and dashboard start on port 8080. Check logs with docker compose logs bot.

6. Environment Variables

Variable	Description	Required
`DISCORD_TOKEN`	Bot token from Discord Developer Portal.	Yes
`MONGO_URI`	MongoDB Atlas SRV connection string.	Yes
`MONGO_DB`	Database name.	Yes
`DASHBOARD_PUBLIC_URL`	Public URL for the dashboard.	Recommended
`XP_PER_MSG`	XP earned per message.	No
`MSG_COOLDOWN_S`	Cooldown in seconds between messages.	No
`FLUSH_EVERY_S`	How often cache flushes.	No

7. Invite the Bot

Generate an OAuth2 invite URL with bot scope and these permissions: Send Messages, Read Message History, Manage Messages, Use Slash Commands, Embed Links. Then add it to your server.

8. Commands

Command	Description
`/checkin`	Daily attendance check-in.
`/daily`	Claim daily coins.
`/balance`	Check your coin balance.
`/shop`	Open the rewards shop.
`/leaderboard`	View top members.
`/help`	Show the full command guide.
`/dashboard`	Get a dashboard auth link.

9. Dashboard

The dashboard is available at https://glyte-bot.duckdns.org/dash/ after running /dashboard in Discord. It shows overview stats, leaderboards, attendance, leaves, bounties, standups, and insights.

10. Troubleshooting

Bot not responding: Run docker compose logs bot and check that the dashboard is running on the correct port.
MongoDB connection error: Verify MONGO_URI and Atlas network access.
Slash commands missing: Restart the bot so Discord can sync commands.
Dashboard shows "Bad link": Run /dashboard again to generate a fresh link.

11. FAQ

Do I need a local MongoDB server?

No. Glyte Bot uses MongoDB Atlas through MONGO_URI.

Can I run this on a free VPS?

Yes, Docker Compose is supported on small VPS instances, but a MongoDB Atlas free tier is required for storage.

How do I update the bot?

Pull the latest code, build, and restart: git pull && docker compose up -d --build.