# Setup & Run (Index)

> Quick Access

> - App: http://127.0.0.1:8000/
> - Sign In: http://127.0.0.1:8000/sign_in.html
> - Wiki: http://127.0.0.1:8000/wiki/

This page collects the most common setup and run steps for the local development environment.

1) Install dependencies

    cd "d:\WebDev\DigitalAssetMgrPro\stitch_digital_asset_manager_pro"
    python -m pip install -r requirements.txt

2) Initialize the database (creates `users.db` and a test user)

    python init_db.py

3) Add or update users (recommended for adding real accounts)

Interactive (recommended):

    python add_user.py --email your-email@example.com
    # type the password at the prompt

Scripted (for automation):

    python add_user.py --email your-email@example.com --password "StrongPassword!"

4) Start the Flask app

    python server.py
    # visit http://127.0.0.1:8000/

5) Start the local documentation wiki

    python -m mkdocs serve -a 127.0.0.1:8001
    # visit http://127.0.0.1:8001/

6) Test login (PowerShell example):

    (Invoke-WebRequest -Method POST -Uri http://127.0.0.1:8000/api/login -Body (@{email='you@example.com';password='YourPassword'} | ConvertTo-Json) -ContentType 'application/json' -UseBasicParsing).Content

7) Access the protected wiki

After signing in via `/sign_in.html`, open the protected docs at:

    Start-Process "http://127.0.0.1:8000/wiki/"

If you try to open `/wiki/` while not signed in the server will redirect you to `/sign_in.html`.

7) Next steps / TODOs

- Add session or JWT-based auth
- Migrate to Postgres/MySQL for production
- Add HTTPS and deploy behind a web server

« Previous Next »