You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add Windows-specific troubleshooting for Docker commands
- Add winpty prefix note for createsuperuser command on Windows
- Add Windows-Specific Issues troubleshooting section
- Document fix for interactive commands hanging in Git Bash/MINGW
- Document fix for 'No such container' errors
Copy file name to clipboardExpand all lines: docs/setup.md
+26-1Lines changed: 26 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,14 +38,19 @@ While the containers are running, open a **separate terminal** and run:
38
38
docker compose run --rm django python manage.py migrate
39
39
40
40
# Create an admin user (you will be prompted for email and password)
41
-
docker compose run --rm django python manage.py createsuperuser
41
+
docker compose run --rm -it django python manage.py createsuperuser
42
42
43
43
# Create OAuth client for authentication
44
44
docker compose run --rm django python manage.py makeclient
45
45
```
46
46
47
47
> **Note:** The `createsuperuser` command prompts you to create login credentials (email and password). Use these credentials to sign into both the Admin Panel and User Interface. If you forget your password, run `createsuperuser` again to create a new admin account.
48
48
49
+
> **Windows Users:** If the `createsuperuser` command hangs or doesn't show prompts, prefix the command with `winpty`:
The ingest command loads datasets, charts, and project configuration from an ingestion file:
@@ -157,3 +162,23 @@ docker compose up
157
162
```
158
163
159
164
GPU acceleration is optional and only needed for accelerated inferencing.
165
+
166
+
### Windows-Specific Issues
167
+
168
+
**Interactive commands don't work or hang:**
169
+
170
+
On Windows (especially Git Bash/MINGW), interactive Docker commands like `createsuperuser` may hang or fail to display prompts. Prefix the command with `winpty`:
171
+
172
+
```bash
173
+
winpty docker compose run --rm -it django python manage.py createsuperuser
174
+
```
175
+
176
+
**"No such container" errors:**
177
+
178
+
If you see errors like `No such container: django` when trying to attach to a running container, use `docker compose run` instead:
179
+
180
+
```bash
181
+
docker compose run --rm -it django python manage.py <command>
182
+
```
183
+
184
+
This creates a new container instance rather than attaching to an existing one.
0 commit comments