Campfire

Campfire is a self-hosted, web-based chat application. It provides a centralized system for team communication, allowing organizations to maintain control over their data by hosting the messaging infrastructure on their own hardware or private cloud servers.

The software is deployed as a server application and is primarily distributed as a Docker image. This image contains all necessary components for a fully functional, single-machine deployment, including the web application, background job processing, caching, and file serving. Users can configure the system via environment variables to enable automatic SSL certificates through Let's Encrypt or to disable SSL for internal HTTP use.

Key features

• Multiple chat rooms with specific access controls
• Direct messaging for private one-on-one conversations
• File attachments with integrated previews
• Search functionality to locate previous messages
• Web Push notifications for real-time alerts
• User @mentions to notify specific team members
• API support for creating and integrating bots

The application is built using the Ruby on Rails framework and follows a single-tenant architecture. In this model, any room designated as public is accessible to every user registered within that specific instance of the software. To support entirely distinct groups of customers or separate organizations, the administrator must deploy multiple independent instances of the application. Data persistence for the database and uploaded file attachments is managed by mapping a Docker volume to the /rails/storage directory.

Upon the first launch, the system guides the administrator through the creation of an admin account. The email address associated with this account is displayed on the login page to ensure users know who to contact for password recovery or account assistance. This administrative role allows for the management of system settings and user permissions.

Campfire is positioned for teams and organizations that require a private, self-managed messaging environment to avoid the monthly fees and data privacy concerns associated with cloud-based chat services.