qdds

Quick Django Dev Server — start your local Django project with your IP exposed for LAN testing.

🚀 What is qdds?

qdds (devserver) is a small CLI tool that runs your Django project's dev server using your local network IP, making it accessible to other devices on your Wi-Fi. Great for testing on mobile or with a team.

By default, it runs on port 80, so other devices on your network can just enter your IP address (like http://192.168.1.50) without needing a port number. 🔥

If that fails due to permissions or port binding restrictions, you can pass --safe to fall back to Django's default port 8000.

🛠 Installation

pip install qdds

📦 Usage

Inside your Django project folder (where manage.py lives):

devserver

This runs:

python manage.py runserver 0.0.0.0:80

That means devices on your Wi-Fi can hit http://<your-ip> with no port required.

If you get a permission error or want to play it safe:

devserver --safe

This runs it on port 8000, just like Django normally would.

🔧 Options

• --safe — Run on port 8000 instead of 80 (for systems that restrict port binding).
• --regular — Skip IP detection and just run on localhost (Django default behavior).

🧪 Development

Clone and install in editable mode:

git clone https://github.com/benmcnelly/qdds.git
cd qdds
pip install -e .

Run tests:

pytest

💬 Why qdds?

Sometimes you just want to fire up Django on your LAN, show a teammate something on their phone, or test a layout in mobile Safari without thinking. qdds makes that effortless.

📝 License

MIT © Ben McNelly