First Setup

First Setup Overview

This guide will walk you through setting up your first ticket system after installation and configuration. You'll learn how to:

• Access the admin dashboard
• Create your first ticket category
• Configure basic permissions
• Test the ticket system
• Set up monitoring

Access the Admin Dashboard

1. Navigate to Your Domain

Open your web browser and go to your configured domain:

https://yourdomain.com

2. Sign in with Discord

1. Click "Sign in with Discord"
2. Authorize the application to access your Discord account
3. You'll be redirected to the dashboard

3. Verify Admin Access

Ensure you have administrator permissions in your Discord server. The dashboard will show:

• Your Discord servers
• System configuration options
• Analytics and monitoring

Create Your First Ticket Category

1. Navigate to Categories

1. Select your Discord server from the dropdown
2. Click on "Ticket Categories" in the sidebar
3. Click "Create Category"

2. Configure Category Settings

3. Advanced Settings

4. Save and Test

1. Click "Save Category"
2. Verify the category appears in your Discord server
3. Test creating a ticket

Configure Basic Permissions

1. Create Support Roles

In your Discord server, create the following roles:

• @Support - Basic support staff
• @Moderator - Senior support staff
• @Admin - Administrative access

2. Set Role Permissions

3. Assign Roles to Staff

1. Go to Server Settings → Roles
2. Assign appropriate roles to your staff members
3. Test permissions by having staff create and manage tickets

Test Your Ticket System

1. Create a Test Ticket

1. Go to your Discord server
2. Navigate to the #support-tickets channel
3. Click the "🎫 Create Ticket" button
4. Verify a new thread is created with the format ticket-0001

2. Test Ticket Management

1. Send a message in the ticket thread
2. Have a staff member respond
3. Test the close ticket functionality
4. Verify the transcript is generated

3. Test Permissions

• Have different role members try to access tickets
• Test who can close and delete tickets
• Verify staff notifications work correctly
• Check that blocked users cannot create tickets

4. Test Auto-Close

Set Up Monitoring

1. Configure Health Checks

# Health check endpoints
GET /api/health          # Web application
GET /health              # Bot service
GET /api/admin/status    # System status

# Test health checks
curl -f https://yourdomain.com/api/health
curl -f https://yourdomain.com/health

2. Set Up Logging

• Configure log rotation
• Set up log monitoring
• Configure error alerts
• Set up performance monitoring

3. Configure Alerts

Performance Optimization

1. Database Optimization

• Create indexes for frequently queried fields
• Set up database monitoring
• Configure connection pooling
• Set up regular backups

2. Cache Configuration

• Configure Redis for session storage
• Set up caching for frequently accessed data
• Configure cache expiration policies
• Monitor cache hit rates

3. Network Optimization

• Enable HTTP/2
• Configure CDN for static assets
• Set up proper caching headers
• Optimize image delivery

Security Checklist

Next Steps

Congratulations! Your ticket system is now operational. Here's what to do next:

1. Create More Categories - Set up specialized ticket types
2. Fine-tune Permissions - Configure role-based access
3. Set Up Analytics - Track performance and usage
4. Configure Auto-Close - Automate ticket management
5. Customize Dashboard - Personalize the interface

Need Help?