Get Started

# Clone the repository
$ git clone https://github.com/repairgenie/lvchat.git
$ cd lvchat

# If you edited any views, rebuild the CSS (only this machine needs Node)
$ npm install && npm run build

# Start the dev server
$ php -S 127.0.0.1:8000 -t public

# Open http://127.0.0.1:8000 in your browser
# Register an account and start chatting!

# Point your web server (Apache/Nginx) document root at public/

# Run the deploy script
$ bash bin/deploy.sh

# The script will:
#   - Create the SQLite database
#   - Set file permissions
#   - Create the admin account
#   - Output the admin password (shown once!)

# Optional: copy .env.example to .env and configure
$ cp .env.example .env

# 1. Install PHP CLI extensions (Linux)
$ sudo apt install php-cli
$ php -m | grep -iE 'pcntl|posix'

# 2. Enable WebSocket mode in Admin → Settings → Realtime
#    Or run: config_set('realtime', 'ws')

# 3. Start the gateway daemon
$ php bin/ws-server.php start -d

# The deploy script handles Composer install automatically
# Gateway listens on port 8080 by default (configurable)

# Build the image
$ docker build -t lvchat .

# Run the container
$ docker run -d -p 8080:80 --name lvchat lvchat

# Open http://localhost:8080