Astuto is a free, open source, self-hosted customer feedback tool. It helps you collect, manage and prioritize feedback from your users. It has been heavely inspired by Canny.io ("astuto", indeed, is the italian translation of the word "canny").
- Collect and manage feedback
- Boards, to divide different types of feedback
- Roadmap, to let your users know what you're working on
- Comments, to discuss with your customers
- Notifications, to inform post owner of comments
- Feedback labels, to inform about the state of a certain feedback
- Feedback updates, to notify your users with news regarding a certain feedback
- Completely customizable (i.e. you can add/edit/remove as many boards, feedback statuses as you want; you can configure the roadmap the way you want; etc.)
- Admin panel (multiple admins/moderators allowed)
- Dark mode
- Docker (installation instructions)
- Docker Compose (installation instructions)
Note: it is strongly suggested to run Astuto on Linux or macOS. As of today, Windows is likely to cause problems. If you want to try anyway, follow along with the Windows users installation guide.
- Ensure that you have the required software installed.
- Clone this repository.
- In Astuto's root directory, create a file named
.envand fill it with the required environment variables (see.env-examplefor an example and check this wiki page for an explanation of the variables). - Run
script/docker-update-and-run.sh. - You should now have a running instance of Astuto at
localhost:3000. A default user account has been created with credentials email:admin@example.com, password:password.
- If you run into any problems take a look at the common problems page.
- When you want to launch Astuto you have to run
script/docker-run.sh. If you installed new gems, packages or updated the database schema, you first need to runscript/docker-update.shand thenscript/docker-run.sh. You can run them together withscript/docker-update-and-run.sh. - You can always run
script/docker-update-and-run.shif unsure whether you should update or not. However, please note thatscript/docker-update-and-run.shtakes more time to run thanscript/docker-run.sh. - If you changed some environment variables in
.envyou have to restart the instance for these changes to take effect.
Astuto is licensed under the GNU GPLv3 license. You are welcome to contribute:
- Join the Discord channel to get in touch.
- You can find a todo list of what we would like to work on right now.
- You should take a look at the contribution guidelines.
- You should take a look at the technologies used to build Astuto.
- You can run the test suite by typing
rspecinside thewebcontainer. Before you can runrspec, you need to uncomment the Google Chrome installation lines indocker/app/Dockerfileand run./script/docker-update-and-run.sh. - If you just have some suggestions you can create an issue, email us directly or text us in our Discord server.