Invite Sakura
Add the bot to your Discord server and review the permissions it needs for the features you plan to use.
Open Discord invite →The server owner needs to configure the invite URL first.
A GENTLE PLACE TO START
Get Sakura set up
your way.
Invite Sakura, choose the features you need, and try your first command.
Open your dashboard
Sign in with Discord, then select a server where you are the owner or have Administrator permission. Sakura must be in that server. The owner password remains available as a separate fallback.
Open the dashboard →Try a command
Sakura's default prefix is a dot. Try .help to open the command guide, or .play with a song title or supported link to start music.
Choose custom card backgrounds.
In the dashboard's Bot settings, add a direct, public HTTPS image URL for the profile card or rank card. These two background settings are global and apply to .p, .r, and .rank commands in every server. Images are fetched by the bot when a card is generated, must be PNG, JPEG, WebP, or GIF (the first GIF frame is used), and must be 5 MB or smaller. Leave a URL blank to restore the Sakura default. Global backgrounds take priority over member profile-store backgrounds.
Configure the dashboard securely.
In your Discord Developer Portal, add https://your-domain.example/auth/discord/callback as an OAuth2 redirect. In your hosting provider's Environment settings, set DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET, DASHBOARD_PUBLIC_URL, and DASHBOARD_OAUTH_REDIRECT_URI to matching HTTPS values. Keep the client secret private. The optional owner password must be a unique random value of at least 24 printable characters. Restart the bot after configuration.
Use the dashboard's backup buttons to export or import a server's settings. Imported values are checked again by the server before they are saved. Unfinished edits are kept as a private browser draft until saved, undone, or cleared.
Customize your member profile.
Sign in with Discord to edit your Sakura display name and short bio, collect credits with the daily reward, and purchase profile backgrounds, badges, and ID designs. Store purchases use your existing Sakura coin balance; each item can be equipped or removed later. Purchased profile cosmetics are saved with your bot account and appear on your Sakura profile card.
Build and send a message, embed, or Components V2 layout.
Open Embed messages in the dashboard, choose a server and a channel, then select Message, Embed, or Components V2. Classic embeds support a custom color, linked author and title, description, fields, images, footer, and timestamp. Components V2 builds a container with a heading, formatted text, a media gallery, accent color, and an optional URL button. Components V2 messages cannot include classic message text or embeds. Use the live preview to review your design before sending. Sakura needs View Channel and Send Messages permission; embeds and V2 media galleries also need Embed Links. Components V2 requires discord.py 2.6.0 or newer. Your Discord account must own the server or have Administrator permission. Drafts are stored only in your current browser and are separated by account and server. External HTTPS image URLs are sent to Discord and are not downloaded by Sakura.
Quick troubleshooting.
If a command does not respond, check that Sakura is online, can view the channel, and that you are using the right prefix. If a role or ticket feature fails, review Sakura's channel permissions and role hierarchy. Visit the status page to check the bot connection.
Play music with a prefix command.
Install FFmpeg on the bot host and make sure its executable is available on PATH. Join a voice channel where Sakura has Connect and Speak permissions, then use .play song title, .play artist name, or a YouTube/SoundCloud HTTPS URL. Use .pause, .resume, .skip, .queue, .stop, or .leave to control playback. The music queue accepts up to 50 tracks. Discord application commands are disabled; use the configured server prefix.
YouTube may block automated requests with a sign-in or bot check. Keep yt-dlp updated; if the host still receives that block, you can optionally provide a cookies file using the YOUTUBE_COOKIES_FILE environment variable set to its path on the bot host. Treat the file like a password: never post or share it, restrict access on the host, and remove or rotate it if exposed. SoundCloud links can be tried without YouTube cookies.
To post a ticket panel after configuring tickets in the dashboard, use .ticket-setup in its target channel. Most ticket controls are available to server administrators.
Only enable what your server needs.
Sakura needs Discord permissions for the features you enable, such as managing messages, assigning roles below its highest role, or creating ticket channels. You can exempt selected channels and roles from the dashboard's invite, trusted-link, and spam filters. The trusted-link filter removes URLs outside the domains you allow. Welcome and goodbye messages are sent only to the channels you select. Custom welcome backgrounds are stored on the bot host for their server.
Dashboard analytics use daily command, message, member, and ticket counts, plus hourly message and member counts for the last 24 hours. Message content and member names are not stored. Choose a 7-, 30-, or 90-day report in Analytics and download the data as CSV, or print the report to save it as PDF.