Ledra Docs

Quick start

A recommended setup order that takes about fifteen minutes.

Ledra works the moment it joins — your existing staff can already moderate, because Ledra honours Discord's own permissions. Everything below is about making it yours.

Do these in order. Each step is independent, so you can stop at any point and come back later.

1. Set up logging first#

Do this before anything else. Once logs are running, every later change is visible and reversible.

/logging set category:all channel:#server-logs

That routes all six categories into one channel. If you would rather split them up — most bigger servers do:

/logging set category:moderation channel:#mod-logs
/logging set category:automod    channel:#mod-logs
/logging set category:messages   channel:#message-logs
/logging set category:members    channel:#join-leave
/logging set category:roles      channel:#server-changes
/logging set category:channels   channel:#server-changes

Check it with /logging status.

Ledra verifies it can actually post in the channel you name and refuses with a clear message if not — so a successful reply means logging really works.

More about logging

2. Give your staff roles a level#

Skip this if your moderators already have Kick Members or Moderate Members in Discord — they can use moderator commands right now.

Set it explicitly when you want staff access without handing out native Discord permissions:

/permissions set role:@Moderator level:moderator
/permissions set role:@Admin     level:admin

Then verify:

/permissions list
/permissions check member:@SomeMod

Only the server owner can grant the admin level. Admins can promote moderators, but not other admins — otherwise any admin could quietly clone their own access.

How permissions work

3. Turn on AutoMod#

AutoMod ships off, and every rule inside it also ships off. Nothing happens until you say so.

Turn on the main switch, then enable the rules you want:

/automod toggle enabled:true
/automod rule rule:spam    enabled:true action:timeout
/automod rule rule:invites enabled:true action:delete
/automod rule rule:mentions enabled:true action:timeout

Protect your staff from your own filters:

/automod exemptlevel level:moderator

Review everything with /automod status.

Start gentle. Use action:delete for a week and read your AutoMod log before escalating to timeout or kick. It is much easier to tighten rules than to apologise for a false positive.

More about AutoMod

4. Welcome new members#

/welcome channel channel:#welcome
/welcome message text:Welcome {user} to **{guild}**! You are member {membercount}.
/welcome test

/welcome channel enables welcome messages and fills in a default text, so after the first command you already have something working. /welcome test previews it privately with your own account — nobody else sees it.

More about greetings · All placeholders

5. Automatic roles and role menus#

Give every new member a base role:

/joinrole add role:@Member

Let members pick their own roles with buttons:

/rolemenu create title:Pick your colours
/rolemenu add menu:1 role:@Red emoji:🔴
/rolemenu add menu:1 role:@Blue emoji:🔵
/rolemenu publish menu:1 channel:#roles

The buttons keep working forever, including across bot restarts.

More about roles

6. Set your time zone#

Only needed if you plan to schedule announcements at a fixed time of day.

/settings timezone name:Europe/Berlin

The option autocompletes as you type. Without this, "09:00" means 09:00 UTC.

Server settings

7. Review everything#

/settings view

One embed with your whole configuration: AutoMod state and active rules, every log channel, greetings, join roles, staff role count, DM behaviour and time zone. The footer lists any log category you have not configured.

What your members get for free#

No setup needed — these work for everyone from the moment Ledra joins:

/remind 2h take the pizza out
/help
/userinfo
/serverinfo
/avatar
/ping

Reminders · Utility commands

Ledra documentation. Everything here describes the hosted bot.