Installation Guide

Overview

This guide walks you through manually installing Event Schedule on your own server. The installation process involves setting up a database, downloading the application files, configuring permissions, and setting up scheduled tasks.

Requirements

Before you begin, ensure your server meets the following requirements:

Required PHP Extensions

• BCMath
• Ctype
• Fileinfo
• JSON
• Mbstring
• OpenSSL
• PDO (with MySQL driver)
• Tokenizer
• XML
• cURL
• GD or Imagick

1. Set Up the Database

Create a MySQL database and user for Event Schedule. Run the following commands in your MySQL client:

CREATE DATABASE eventschedule;
CREATE USER 'eventschedule'@'localhost' IDENTIFIED BY 'change_me';
GRANT ALL PRIVILEGES ON eventschedule.* TO 'eventschedule'@'localhost';

2. Download the Application

Download the latest release and extract it to your web server's document root.

1. Download eventschedule.zip from the latest GitHub release
2. Upload the zip file to your server
3. Extract the contents to your web root directory

# Example: Extract to web root
cd /var/www
unzip eventschedule.zip

3. Set File Permissions

Ensure the web server has proper permissions to write to storage and cache directories.

cd /path/to/eventschedule
chmod -R 755 storage
sudo chown -R www-data:www-data storage bootstrap public

4. Configure Environment

Copy the example environment file to create your configuration:

cp .env.example .env

Now access your application at https://your-domain.com in your browser. You'll see the setup wizard where you can configure:

• Database connection details
• Application name and URL
• Email settings
• Admin account credentials

5. Set Up the Cron Job

Event Schedule requires a cron job to run scheduled tasks like sending reminder emails, syncing calendars, and releasing expired ticket reservations.

Add the following line to your server's crontab:

* * * * * php /path/to/eventschedule/artisan schedule:run

Adding the Cron Job

To edit your crontab, run:

crontab -e

Add the cron line at the end of the file, making sure to replace /path/to/eventschedule with your actual installation path.

Verification

After completing the installation, verify everything is working correctly:

1. Access the application: Visit https://your-domain.com and confirm the homepage loads
2. Create an account: Register a new user account to verify database connectivity
3. Create a schedule: Create a test schedule and add an event
4. Check logs: Review storage/logs/laravel.log for any errors

Next Steps

Now that Event Schedule is installed, you may want to:

• Configure Stripe payments for ticket sales
• Set up Google Calendar integration
• Set up Twilio SMS for phone verification (set TWILIO_SID, TWILIO_AUTH_TOKEN, and TWILIO_FROM_NUMBER in your .env)
• Configure email settings for notifications
• Customize your branding and appearance

Troubleshooting

"Permission denied" writing storage/logs/laravel.log

The web-server user cannot write to storage (and often .env). Re-run the ownership and permission commands from the file permissions step, making sure to use the user your web server actually runs as. On Alpine-based Docker images that is the numeric UID 82, not www-data.

A 500 error, or you can't get back to the setup wizard

This usually means the database has no tables yet (migrations did not run). The setup wizard reappears automatically whenever the database is empty, so fix the underlying cause (database privileges or the file permissions above) and reload the page to run setup again.

Custom translations

Rename built-in UI terms (for example "Talent" to "Artist", or "Curator" to "Event Planner") without your changes being wiped out by php artisan app:update.

Drop a PHP file in:

storage/app/lang/{locale}/{file}.php

The three files you can override are messages.php (UI strings), accessibility.php, and marketing.php. List the keys you want to change and nothing else; the bundled translations fill in the rest:

<?php
// storage/app/lang/en/messages.php
return [
    'talent' => 'Artist',
    'talents' => 'Artists',
    'curator' => 'Event Planner',
    'curators' => 'Event Planners',
];

Create one directory per locale you want to override (en, es, fr, …). The full list of supported locales lives in config/app.php under supported_languages.