Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
56 lines (41 sloc) 3.98 KB

GitHub GitHub last commit

Try the online demo!



What is Astuto?

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"). If you are interested, you can check out a demo of Astuto.

Requirements

Installation

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.

  1. Ensure that you have the required software installed.
  2. Clone this repository.
  3. In Astuto's root directory, create a file named .env and fill it with the required environment variables (see .env-example for an example and check this wiki page for an explanation of the variables).
  4. Run script/docker-update-and-run.sh.
  5. 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.

Post-installation notes

  • 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 run script/docker-update.sh and then script/docker-run.sh. You can run them together with script/docker-update-and-run.sh.
  • You can always run script/docker-update-and-run.sh if unsure whether you should update or not. However, please note that script/docker-update-and-run.sh takes more time to run than script/docker-run.sh.
  • If you changed some environment variables in .env you have to restart the instance for these changes to take effect.

Contributing

Astuto is licensed under the GNU GPLv3 license. You are welcome to contribute:

You can’t perform that action at this time.