Getting Started

Getting Started with CloudAlt Backend

Prerequisites

• Python 3.11+
• PostgreSQL (or Supabase account)
• GCP account (for Firestore and Cloud Storage)
• Git

Installation

1. Clone Repository

git clone https://github.com/xavierdurant/cloudalt-backend.git
cd cloudalt-backend

2. Set Up Virtual Environment

For Stays Service (Port 8000)

cd stays/
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r ../requirements.txt

For Discovery Service (Port 8001)

cd discovery/
python -m venv venv
source venv/bin/activate
pip install -r ../requirements.txt

For Services (Port 8002)

cd services/
python -m venv venv
source venv/bin/activate
pip install -r ../requirements.txt

3. Configure Environment Variables

Copy the example environment file:

cp .env.example .env

Edit .env with your credentials (see Environment Variables).

4. Run Migrations

python manage.py migrate

5. Create Superuser

python manage.py createsuperuser

6. Start Development Server

python manage.py runserver 8000  # For stays
python manage.py runserver 8001  # For discovery
python manage.py runserver 8002  # For services

Verify Installation

Visit http://localhost:8000/admin/ to access Django admin.

Next Steps

• Architecture Overview
• API Reference
• Deployment Guide