Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
---
title: "Installing Spree"
sidebarTitle: Installation
description: "Install Spree Commerce locally, run your first store, and deploy it to production with the official starter template."
canonical: "https://spreecommerce.org/docs/developer/getting-started/quickstart"
---
## Using `create-spree-app`
The quickest way to get started. Scaffolds a full Spree project with Next.js Storefront (optional).
**Requirements:** [Node.js](https://nodejs.org/) 20+ and [Docker](https://docs.docker.com/get-docker/) running.
```bash
npx create-spree-app@latest my-store
```
The CLI walks you through an interactive setup:
1. Choose **Full-stack** (Backend + Next.js Storefront) or **Backend only**
2. Optionally load **sample data** (products, categories, images)
Once complete, your store should be running at [http://localhost:3000/admin](http://localhost:3000/admin). The port can be different if `3000` is already used on your system.
See the full [create-spree-app documentation](/v5/developer/create-spree-app/quickstart) for all CLI flags and options.
## Accessing Admin Panel
Navigate to [http://localhost:3000/admin](http://localhost:3000/admin) and log in with the default credentials:
| | |
|---|---|
| **Email** | `[email protected]` |
| **Password** | `spree123` |
Upon successful authentication, you should see the admin screen:
<Frame caption="Spree Admin Dashboard">
<img src="/images/spree_admin_dashboard.png" />
</Frame>
## Using the Spree CLI
Projects scaffolded with `create-spree-app` include [`@spree/cli`](/v5/developer/cli/quickstart) for managing the backend and calling the Admin API. Because it's a project dependency, run it with `npx` (or any package-manager script):
```bash
npx spree dev # boot the Docker stack
npx spree api get products # query the Admin API (read-only key preconfigured)
```
Project setup mints a read-only Admin API key into `.spree/credentials.json` (and `spree api` mints it on first use if you skipped setup), so `spree api` works without any extra configuration.
To call `spree` directly without the `npx` prefix, install the CLI globally:
```bash
npm install -g @spree/cli
spree api get products
```
See the [Spree CLI guide](/v5/developer/cli/quickstart) for all commands and the [Admin API from the CLI](/v5/developer/cli/admin-api) for querying your store's data.
## Next Steps
<CardGroup cols={2}>
<Card title="Build with AI Agents" icon="bot" href="/developer/agentic/overview">
Install the Spree agent skills and connect the docs MCP server — Claude Code, Cursor, Copilot, and 60+ other tools learn Spree's conventions and build features with you.
</Card>
<Card title="Customization Tutorial" icon="graduation-cap" href="/developer/tutorial/introduction">
Build a complete custom feature — model, admin UI, API, and TypeScript SDK — step by step.
</Card>
<Card title="Core Concepts" icon="brain" href="/developer/core-concepts/architecture">
Understand how Spree models commerce — stores, products, orders, payments.
</Card>
<Card title="Next.js Storefront" icon="react" href="/developer/storefront/nextjs/quickstart">
Customize and extend the headless storefront.
</Card>
</CardGroup>
<Tip>
Using an AI coding agent? Run `npx skills add spree/agent-skills` in your new project — it teaches your agent the customization patterns before you write a line of code. See [Agentic Development](/v5/developer/agentic/overview).
</Tip>
---
Congrats! You've set up your Spree Commerce and it's looking amazing!
Give Spree a [GitHub Star](https://github.com/spree/spree)<Icon icon="star" iconType="solid" color="#FFD43B" />, why don't ya? Thank you for supporting Spree open-source! <Icon icon="heart" iconType="solid" color="#FF0000" />
Need support or want to give some feedback? Join our [Discord](https://discord.spreecommerce.org/)