README.md

💖 Found Hi.Events helpful?
⭐ Please consider giving us a star to support the project! ⭐

Hi.Events

Open-source event management and ticketing platform to sell tickets online for events of all sizes

Try Cloud ☁️ • Demo Event 🌟 • Website 🌎 • Documentation 📄 • Installation ⚙️

---

Deutsch | Português | Français | Español | 中文 (Zhōngwén) | 日本語

---

📚 Introduction

Hi.Events is a feature-rich, self-hosted event management and ticketing platform that helps you sell tickets online for all types of events. From conferences and workshops to club nights and concerts, Hi.Events provides everything you need to create, manage, and monetize your events with ease.

Generated using Screenshot Rocks

⚡ Quick Deploy

Get started in minutes with our one-click deployment options:

🌟 Key Features

Hi.Events offers comprehensive tools to streamline your event management:

🎟 Ticketing & Sales

• Multiple Ticket Types: Create free, paid, donation-based, and tiered tickets
• Capacity Management: Set limits per event or ticket type
• Promo Codes & Discounts: Drive early sales with special offers
• Product Upsells: Sell merchandise and add-ons alongside tickets
• Custom Pricing: Apply taxes and fees per product or entire order

🏆 Event Management

• Real-time Dashboard: Track sales, revenue, and attendee metrics
• Visual Page Editor: Design beautiful event pages with live preview
• Website Integration: Embed ticketing widgets on your existing site
• SEO Optimization: Customize metadata for better search visibility
• Offline Event Support: Provide location details and instructions

📱 Attendee Experience

• Custom Registration Forms: Collect exactly the information you need
• QR Code Check-In: Fast, mobile-friendly entry verification
• Multi-language Support: Reach global audiences with localized interfaces
• Bulk Communication: Send targeted messages to specific ticket holders
• Refund Management: Process full or partial refunds when needed

🔧 For Organizers

• Team Collaboration: Role-based access for staff members
• Webhook Integration: Connect with Zapier, IFTTT, Make, or your CRM
• Stripe Connect: Receive instant payouts for ticket sales
• Comprehensive API: Build custom integrations with full API access
• Advanced Reporting: Generate sales, tax, and usage reports

🚀 Getting Started

🐳 Quick Start with Docker

Important

Please ensure you have Docker and Docker Compose installed on your system. If not, you can download them from the official Docker website: Docker.

1. Clone the Repository:

   git clone [email protected]:HiEventsDev/hi.events.git

2. Navigate to the Docker Directory:

   cd hi.events/docker/all-in-one

3. Generate the APP_KEY and JWT_SECRET

   Generate the keys using the following commands:

   Unix/Linux/MacOS:

   echo base64:$(openssl rand -base64 32)  # For APP_KEY
   openssl rand -base64 32                 # For JWT_SECRET

   Windows: Check the instructions in ./docker/all-in-one/README.md for generating the keys on Windows.

   Add the generated values to the .env file located in ./docker/all-in-one/.env:

4. Start the Docker Containers:

   docker compose up -d

5. Create an account:

   Open your browser and navigate to http://localhost:8123/auth/register
   

ℹ️ For detailed setup instructions including production deployment, please refer to our getting started guide.

💜 Sponsors

Support the Project

If you find Hi.Events valuable for your organization, please consider supporting ongoing development:

Or support us on: GitHub Sponsors | Open Collective

📝 Change Log

Stay updated with our latest features and improvements on our GitHub releases page.

🤝 Contributing

We welcome contributions from the community! Please see our contributing guidelines for details on how to get involved.

❓ FAQ

Have questions? Our documentation has answers. For additional support, contact us at [email protected].

📜 License

Hi.Events is licensed under the AGPL-3.0 license.

For more licensing information, including commercial licencing options, please visit our licensing page here.