Installation¶

Docker Deployment¶

Development / Demo Mode¶

Steps:¶

1. Start the application:

   make docker-server
   

   This copies .env.dev-sample to .env.dev (if it doesn't exist yet), builds the Docker image, and starts the stack. Equivalent to running these manually:

   cp .env.dev-sample .env.dev
   docker build -t wine-cellar-dev .
   docker compose up
   

2. (optional): populate database with some sample data:

   make docker-fixtures
   

Local Setup¶

Prerequisites¶

Ensure your system has:

• Python 3.x
• Node.js (v24.x or higher recommended)

Getting Started¶

1. Clone the Repository¶

git clone https://github.com/the-broke-sommeliers/wine-cellar.git
cd wine-cellar

2. Install Dependencies¶

make install

3. Load Sample Data (Optional)¶

make fixtures

4. Run the Development Server¶

make watch

Access the app at http://127.0.0.1:8003/.