Skip to content

HiEventsDev/Hi.Events

Repository files navigation

๐ŸŒŸ 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


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

๐ŸŒŸ Features

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

  • ๐Ÿ“Š Event Analytics: Gain deep insights into event performance and ticket sales.
  • ๐ŸŽŸ Embeddable Ticket Widget: Easily integrate ticket sales into any website.
  • ๐Ÿ–ฅ Customizable Event Homepages: Create eye-catching event pages with flexible design options.
  • ๐Ÿ”‘ Intuitive Check-In Tools: Easily check in attendees at the door with Hi.Events' QR code check-in tool.
  • ๐Ÿ’ฌ Event Messaging Tools: Message attendees with important updates and reminders.
  • ๐Ÿ“ Custom Order Forms: Collect attendee information with tailored questions at checkout.
  • ๐ŸŽซ Multiple Ticket Types: Free, paid, donation, or tiered ticket types.
  • ๐Ÿ’ธ Versatile Promo Codes: Highly versatile discount codes. Pre-sale access, multiple discount options.
  • ๐Ÿ’ฐ Instant Payouts: Enjoy instant payouts with seamless Stripe integration.
  • ๐Ÿงพ Tax and Fee Configuration: Add tax and fees on a per-ticket basis.
  • ๐Ÿ“ฆ Data Exports: Export attendee and order data to XLSX or CSV.
  • ๐Ÿ’ป REST API: Full-featured REST API for custom integrations.
  • ๐Ÿ” SEO Tools: Customize SEO settings for each event.
  • ๐Ÿ›’ Beautiful Checkout Process: Ensure a smooth, beautiful checkout experience.
  • ๐Ÿ” Role-Based Access: Support for multiple user roles.
  • ๐Ÿ’ป Online Event Support: Offer online event instructions and links.
  • โช Full and Partial Refund Support: Manage full and partial refunds with ease.
  • ๐Ÿ“ง Email Notifications: Keep attendees informed with automated email notifications.
  • ๐Ÿ“ฑ Mobile-Responsive: Enjoy a seamless experience on any device.
  • ๐ŸŒ Multi-Language Support: Support for multiple languages (English, Portuguรชs, Espaรฑol, ไธญๆ–‡ (Zhลngwรฉn), Deutsch, Franรงais)
  • ๐Ÿ”‹ Advanced Capacity Management: Set capacity limits across multiple ticket types.
  • ๐ŸŽ‰ And much more!

๐Ÿš€ 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 [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.

โ„น๏ธ Please refer to the getting started guide for other installation methods, and for setting up a production or local development environment.

๐Ÿ’œ Support Hi.Events

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

Buy Me A Coffee
or Sponsor on GitHub

๐Ÿ“ Change Log

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

๐Ÿค Contributing

We welcome contributions, suggestions, and bug reports! Before proposing a new feature or extension, please open an issue to discuss it.

โ“ 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 [email protected].

๐Ÿ“œ 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.