1ee17cc826
* updated development docker setup * turned on yarn integrity check * create test docker compose and update development dockerfile * create docker Readme.md file * fix README.md file * create docker-copmose and dockerfile for production/staging environment setup * added mailhog to catch email * remove yarn integrity check in development mode! * Update Readme.md file to support mailhog inbox * update link to docker development guide from mail README * remove .env.development and use .env.example for docker as .env.development was mixing with circleci config * make the dockerfile configurable like before * update docker-compose as per suggesion in PR * create docker setup docs * Revert accidental deletion * fix: typo for branding consistency * fix typo * update the code as per recommendation in PR * remove package-lock and add gitignore * fix vulnerability AND update env for tests to pass * Fix yarn integrity check across different docker services * update code based on rubocop and PR suggestions * remove redundant test docker-compose and dockerfile * update rails entrypoint, update docs and Gemfile * [Rubocop] order Gemfile alphabetically * Reordering Gemfile
67 lines
3.7 KiB
Markdown
67 lines
3.7 KiB
Markdown
<p align="center">
|
|
<img src="https://storage.googleapis.com/chatwoot-assets/woot-logo.svg" alt="Woot-logo" width="240">
|
|
|
|
<div align="center">A simple and elegant live chat software</div>
|
|
<div align="center">An opensource alternative to Intercom, Zendesk, Drift, Crisp etc.</div>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://heroku.com/deploy?template=https://github.com/chatwoot/chatwoot/tree/master" alt="Deploy to Heroku">
|
|
<img alt="Deploy" src="https://www.herokucdn.com/deploy/button.svg"/>
|
|
</a>
|
|
</p>
|
|
|
|
___
|
|
|
|
<p align="center">
|
|
<a href="https://codeclimate.com/github/chatwoot/chatwoot/maintainability"><img src="https://api.codeclimate.com/v1/badges/80f9e1a7c72d186289ad/maintainability" alt="Maintainability"></a>
|
|
<img src="https://img.shields.io/circleci/build/github/chatwoot/chatwoot" alt="CircleCI Badge">
|
|
<a href="https://hub.docker.com/r/chatwoot/chatwoot/"><img src="https://img.shields.io/docker/cloud/build/chatwoot/chatwoot" alt="Docker Build Badge"></a>
|
|
<img src="https://img.shields.io/github/license/chatwoot/chatwoot" alt="License">
|
|
<img src="https://img.shields.io/github/commit-activity/m/chatwoot/chatwoot" alt="Commits-per-month">
|
|
<img src="https://img.shields.io/discord/647412545203994635" alt="Discord">
|
|
<a href="https://discord.gg/cJXdrwS"><img src="https://img.shields.io/badge/chat-Discord-violet?logo=discord" alt="Chat on Discord"></a>
|
|
</p>
|
|
|
|
|
|
|
|
## Background
|
|
|
|
Chatwoot is a customer support tool for instant messaging channels which can help businesses to provide exceptional customer support. The development of Chatwoot started in 2016 and it failed to succeed as a business and eventually shut the shop in 2017. During 2019 #Hacktoberfest, the maintainers decided to make it opensource instead of letting the code rust in a private repo. With a pleasant surprise, Chatwoot became a trending project on Hacker News and best of all, got lots of love from the community.
|
|
|
|
Now, a failed project is back on track and the prospects are looking great. The team is back to working on the project and we are building it in the open. Thanks to the ideas and contributions from the community.
|
|
|
|
## Documentation
|
|
|
|
Detailed documentation is available at [www.chatwoot.com/docs](https://www.chatwoot.com/docs).
|
|
|
|
You can find the quick setup docs [here](https://www.chatwoot.com/docs/quick-setup).
|
|
|
|
## Heroku one-click deploy
|
|
|
|
Deploying chatwoot to heroku, it's a breeze. It's as simple as clicking this button.
|
|
|
|
[](https://heroku.com/deploy?template=https://github.com/chatwoot/chatwoot/tree/master)
|
|
|
|
Follow this [link](https://www.chatwoot.com/docs/environment-variables) to understand setting the correct environment variables for the app to work with all the features. There might be breakages if you do not set the relevant environment variables. This applies to deploying the docker image as well.
|
|
|
|
## Docker
|
|
|
|
You can use our official Docker image from [https://hub.docker.com/r/chatwoot/chatwoot](https://hub.docker.com/r/chatwoot/chatwoot)
|
|
|
|
```bash
|
|
docker pull chatwoot/chatwoot
|
|
```
|
|
|
|
Follow our [environment variables](https://www.chatwoot.com/docs/environment-variables/) guide to setup environment for Docker.
|
|
|
|
Follow our [docker development guide](docker/README.md) to develop and debug the application using docker composer.
|
|
|
|
## Contributors ✨
|
|
|
|
Thanks goes to all these [wonderful people](https://www.chatwoot.com/docs/contributors):
|
|
|
|
<a href="https://github.com/chatwoot/chatwoot/graphs/contributors"><img src="https://opencollective.com/chatwoot/contributors.svg?width=890&button=false" /></a>
|
|
|
|
|
|
*Chatwoot* © 2017-2019, ThoughtWoot Inc - Released under the MIT License.
|