Skip to content

Installation and Setup

Baytae Tistear edited this page Jul 7, 2026 · 2 revisions

Installation and Setup

Parent section: Home

This section explains the first-time setup order for SDAC. Keep the order simple:

  1. Install the server.
  2. Configure the Discord bot.
  3. Configure the dashboard.
  4. Verify health.
  5. Configure backups and updates.

Use the dedicated setup pages instead of trying to do everything from one giant checklist:

What You Need Before Starting

You need:

  • A Linux server, normally Ubuntu.
  • A public domain if the dashboard and OAuth should be reachable outside the server.
  • A Discord application and bot from the Discord Developer Portal.
  • Access to the SDAC GitHub repository/releases.
  • A plan for backups before production use.

Do not paste secrets into documentation, issue comments, or screenshots. Keep tokens and secrets only in the server env file or appropriate secret store.

Recommended Production Layout

Standard app directory:

/home/ubuntu/discord-screenshot-bot

Standard env file:

/etc/sdac-bot/sdac.env

Local dashboard:

http://127.0.0.1:5000

Public dashboard example:

https://freethefishies.us.to

Setup Flow

  1. Clone or install SDAC on the server.
  2. Create the Python virtual environment and install dependencies.
  3. Create the server env file with Discord and dashboard values.
  4. Run database migrations.
  5. Install or configure sdac-bot.service and sdac-dashboard.service.
  6. Configure Nginx and HTTPS if the dashboard is public.
  7. Create the first dashboard owner account.
  8. Invite the bot to Discord.
  9. Run /setup, /setuptest, and /diagnose.
  10. Configure categories, channels, features, roles, backups, and notifications.

After Setup

Verify:

  • Bot service is running.
  • Dashboard service is running.
  • /health returns healthy.
  • Public HTTPS works.
  • Slash commands appear in Discord.
  • /submit can complete a test submission.
  • Dashboard login works.
  • Discord OAuth works if enabled.
  • Backup and restore test works.
  • Release/update page can see current releases.

Related Pages

Clone this wiki locally