Installation¶

Docker Deployment¶

Development / Demo Mode¶

Steps:¶

1. Copy the development environment configuration:

   cp .env.dev-sample .env.dev
   

2. Build the Docker image:

   docker build -t wine-cellar-dev .
   

3. Start the application:

   docker compose up
   

4. (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/.