Skip to main content
Spree works with PostgreSQL, MySQL, and SQLite databases. The installer defaults to SQLite for quick setup. You can switch to PostgreSQL or MySQL at any time later. Learn more about database configuration.

​
Installation options

Use the guided installer to set up your Spree application with all the required dependencies (system libraries, Ruby language) on your system.Copy and paste the following command to your terminal:
bash -c "$(curl -fsSL https://spreecommerce.org/install)"
This will fire up the guided installer that will ask you a few questions (eg. application name, load sample data, etc.) and then set up your Spree application.
System RequirementsMacOS:
  • MacOS 14.0+
  • XCode command line tools installed
Windows:
  • Windows Subsystem for Linux is required, you can install it via wsl --install
If you have any issues with the installer, please create an issue on GitHub. Thank you!

​
Accessing Admin Panel

Use your browser window to navigate to http://localhost:3000/admin. You can log in with the credentials you’ve chosen during installation, the defaults are: login: 
spree@example.com
password: 
spree123
Upon successful authentication, you should see the admin screen:
Congrats! You’ve set up your Spree Commerce and it’s looking amazing! Give Spree a GitHub Star, why dont’t ya? Thank you for supporting Spree open-source! Need support or want to give some feedback? Join our community with 6000+ members or drop us an email at hello@spreecommerce.org.