Skip to content

Files

Latest commit

 

History

History
206 lines (152 loc) · 9.24 KB

README.md

File metadata and controls

206 lines (152 loc) · 9.24 KB
🌟 A star would be much appreciated! 🌟

Hi.Events Logo

Hi.Events

Demo Event 🌟 • Website 🌎 • Documentation 📄 • Installation ⚙️

Open-source event management and ticketing platform.

Share on AddToAny X (formerly Twitter) Follow
Hi.Events docs License: AGPL v3 GitHub Release Run Unit Tests Docker Pulls

HiEventsDev%2Fhi.events | Trendshift

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

Table of Contents

📚 Introduction

Hi.Events is a feature-rich, self-hosted event management and ticketing platform. From conferences to club nights, Hi.Events is designed to help you create, manage, and sell tickets for events of all sizes.

Hi.Events self-hosted ticket selling dashboard

Generated using Screenshot Rocks

🌟 Features

Hi.Events is packed with features to streamline your event management and ticketing:

🎟 Ticketing & Product Sales

  • Multiple Ticket Types: Free, Paid, Donation, and Tiered tickets.
  • Capacity Management: Set event-wide or ticket-specific limits.
  • Capacity Assignments: Manage shared capacity across multiple ticket types.
  • Promo Codes: Discount codes for pre-sale access and special offers.
  • Product Sales: Sell event-related products (e.g., t-shirts, add-ons).
  • Taxes & Fees: Apply custom taxes and fees per product or order.

🏆 Event Management & Customization

  • Event Dashboard: Real-time revenue, ticket sales, and attendee analytics.
  • Homepage Designer: Customize event pages with a live preview editor.
  • Embeddable Ticket Widget: Add a seamless ticketing experience to your website.
  • SEO Tools: Customize event metadata for better search visibility.
  • Product Categories: Organize products and tickets with category management.
  • Offline Event Support: Provide instructions for physical events.

📧 Attendee & Order Management

  • Custom Checkout Forms: Collect attendee details with tailored questions.
  • Attendee Management: Search, edit, cancel, and message attendees.
  • Order Management: Refund, cancel, and resend order details easily.
  • Bulk Messaging: Email or message specific ticket holders.
  • Data Exports: Export attendees and orders to CSV/XLSX.

📱 Mobile-Friendly & Check-In Tools

  • QR Code Check-In: Web-based and mobile-friendly check-in tool.
  • Check-In Lists: Generate and share access-controlled check-in lists.
  • Multi-User Access: Role-based access control for event staff.

🔧 Integrations & Automation

  • Webhooks Support: Automate tasks with Zapier, IFTTT, Make, or CRM integrations.
  • Stripe Connect Integration: Organizers get instant payouts.

📊 Advanced Features

  • Multi-Language Support: English, Deutsch, Español, Português, Français, 中文 (Zhōngwén), and more.
  • Partial & Full Refunds: Manage refunds with detailed order tracking.
  • Role-Based Access Control: Multiple user roles with permission management.
  • REST API: Full API access for custom integrations.
  • Invoicing System: Generate and send invoices with tax details, payment terms, and due dates.
  • Offline Payment Support: Enable bank transfers, cash payments, or custom payment methods.
  • Event Archive: Archive past events to keep the dashboard organized.
  • Advanced Ticket Locking: Lock tickets behind promo codes or access restrictions.
  • Advanced Reporting: Daily sales, tax breakdowns, product sales, and promo code usage reports.

🚀 Getting Started

For detailed installation instructions, please refer to our documentation. For a quick start, follow these steps:

One-Click Deployments

Deploy on DigitalOcean

Deploy to Render

Deploy on Railway

Deploy on Zeabur

🐳 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 git@github.com: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.

ℹ️ Please refer to the getting started guide for other installation methods, and for setting up a production or local development environment.

💜 Sponsors

Stinking Badges

Making a Donation

If you find Hi.Events useful, it would be massively appreciated if you made a small donation to help support the project.

We'll use your donation to fund ongoing development and maintenance of Hi.Events.

Buy Me A Coffee
or Sponsor on GitHub or Sponsor on Open Collective

📝 Change Log

Stay updated with our ongoing improvements and feature additions at our GitHub releases page.

🤝 Contributing

We welcome contributions, suggestions, and bug reports! Please see our contributing guidelines for more information.

❓ FAQ

Have questions? Our Docs have answers. If you can't find what you're looking for, feel free to reach out to us at hello@hi.events.

📜 License

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

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