# Rallly Meeting Scheduler

> Self-hosted Doodle alternative for scheduling meetings and events.

- Category: Productivity & Collaboration
- Difficulty: beginner
- Components: rallly, postgresql
- Tags: scheduling, meetings, doodle-alternative, rallly, polls
- Source: https://docker.recipes/productivity/rallly-scheduling

## Overview

Rallly is a modern, open-source meeting scheduler that serves as a self-hosted alternative to Doodle and other commercial polling platforms. Built with Next.js and designed for privacy-conscious organizations, Rallly allows users to create time-slot polls for meeting coordination without requiring participants to create accounts. The platform emphasizes simplicity and user experience while giving organizations full control over their scheduling data and participant information.

This deployment combines the Rallly application container with a dedicated PostgreSQL database instance. The rallly service runs the Node.js-based web application on port 3000, while the db service provides persistent data storage using PostgreSQL 15 Alpine. The configuration includes comprehensive email integration through SMTP settings, enabling automated notifications when participants vote on polls or when poll creators receive responses.

This stack is ideal for teams, organizations, and communities that need reliable meeting coordination without depending on external services or compromising participant privacy. The PostgreSQL backend ensures data integrity and supports complex queries for reporting and analytics, while the containerized approach simplifies deployment across different environments from development to production.

## Features

- Anonymous poll participation without requiring user accounts or registrations
- Real-time poll updates showing participant responses as they vote
- Comprehensive SMTP email integration for poll notifications and reminders
- PostgreSQL backend with ACID compliance for reliable data persistence
- Responsive web interface optimized for both desktop and mobile devices
- Customizable poll options with time slots, dates, and text-based choices
- Poll creator dashboard for managing multiple polls and viewing analytics
- Privacy-focused design with self-hosted data storage and no external tracking

## Use cases

- Remote teams coordinating weekly standup meetings across different time zones
- Event organizers scheduling workshops, webinars, or community meetups
- Educational institutions coordinating office hours, study groups, or parent-teacher conferences
- Healthcare practices allowing patients to vote on preferred appointment slots
- Project managers finding optimal times for sprint planning or retrospective meetings
- Non-profit organizations scheduling volunteer meetings and board sessions
- Family or friend groups coordinating social events, dinners, or vacation planning

## Prerequisites

- Docker and Docker Compose installed with minimum 1GB RAM for PostgreSQL performance
- Environment variables configured for database password and application secret
- SMTP server credentials for email notifications and poll invitations
- Base URL configuration matching your domain or IP address for proper link generation
- Port 3000 available for web interface access
- Basic understanding of poll creation workflows and participant management

## docker-compose.yml

```yaml
services:
  rallly:
    image: lukevella/rallly:latest
    container_name: rallly
    environment:
      - DATABASE_URL=postgres://rallly:${DB_PASSWORD}@db:5432/rallly
      - SECRET_PASSWORD=${SECRET_PASSWORD}
      - NEXT_PUBLIC_BASE_URL=${BASE_URL}
      - SUPPORT_EMAIL=${SUPPORT_EMAIL}
      - SMTP_HOST=${SMTP_HOST}
      - SMTP_PORT=${SMTP_PORT}
      - SMTP_USER=${SMTP_USER}
      - SMTP_PWD=${SMTP_PASSWORD}
      - SMTP_SECURE=false
    ports:
      - "3000:3000"
    depends_on:
      - db
    networks:
      - rallly-network
    restart: unless-stopped

  db:
    image: postgres:15-alpine
    container_name: rallly-db
    environment:
      - POSTGRES_USER=rallly
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=rallly
    volumes:
      - postgres-data:/var/lib/postgresql/data
    networks:
      - rallly-network
    restart: unless-stopped

volumes:
  postgres-data:

networks:
  rallly-network:
    driver: bridge
```

## .env

```bash
# Rallly
BASE_URL=http://localhost:3000
SUPPORT_EMAIL=support@example.com

# Generate with: openssl rand -base64 32
SECRET_PASSWORD=your_secret_password
DB_PASSWORD=secure_rallly_password

# SMTP Settings
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=rallly@example.com
SMTP_PASSWORD=smtp_password
```

## Usage notes

- Web UI at http://localhost:3000
- Create polls without account
- Share poll links with participants
- Email notifications for votes
- Self-hosted Doodle alternative

## Troubleshooting

- Database connection refused errors: Verify DB_PASSWORD environment variable matches between rallly and db services
- Email notifications not sending: Check SMTP credentials and ensure SMTP_HOST is reachable from the container network
- Poll links showing localhost in emails: Update NEXT_PUBLIC_BASE_URL to match your actual domain or IP address
- Container startup failures: Ensure postgres-data volume has proper permissions and sufficient disk space
- Web interface showing 502 errors: Check that rallly container can connect to db service on port 5432 within rallly-network
- Participants unable to access polls: Verify BASE_URL configuration and firewall settings for port 3000

