Skip to content

Commit 2b18260

Browse files
committed
feat: 📝 Update docs for mobile local dev
Signed-off-by: James Manuel <moodyjmz@users.noreply.github.com>
1 parent 0e075de commit 2b18260

1 file changed

Lines changed: 12 additions & 6 deletions

File tree

develop/README.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ The docker compose environment in this directory allows to run document server b
88
- `make` to use the image that is currently available locally
99
- `make pull` to use the latest image from github
1010
- `make build` to build the image locally from scratch
11+
- `make mobile` for Android emulator / physical LAN device testing (see below)
1112

1213
You may need to generate a PAT first, as described in https://github.com/Euro-Office/DocumentServer/pkgs/container/documentserver
1314
- In docker-compose.yml, for the eo service, ensure that `target` is set to `develop`
@@ -26,16 +27,19 @@ The docker compose environment in this directory allows to run document server b
2627

2728
#### Testing from mobile devices and emulators
2829

29-
`make local` auto-detects the host's LAN IP (`HOST_LAN_IP`) so phones, tablets, and simulators/emulators can reach the editor — `localhost` only works from the desktop itself.
30+
`make local` runs on `localhost` — enough for the desktop browser and iOS simulator. For Android emulators and physical devices on the LAN, use `make mobile` instead — it detects the host's LAN IP and injects it so the editor is reachable from off-desktop clients.
3031

31-
- **iOS simulator & desktop browser**: reach Nextcloud at `http://localhost:8081/` as usual.
32-
- **Android emulator**: log in at `http://10.0.2.2:8081/` (the emulator's alias for the host). Already trusted by the stack.
33-
- **Physical device on the same LAN**: log in at `http://<HOST_LAN_IP>:8081/`. `HOST_LAN_IP` is appended to Nextcloud's trusted domains automatically.
32+
| Client | Target | Nextcloud URL |
33+
|---|---|---|
34+
| Desktop browser | `make local` or `make mobile` | `http://localhost:8081/` |
35+
| iOS simulator | `make local` or `make mobile` | `http://localhost:8081/` |
36+
| Android emulator | `make mobile` | `http://10.0.2.2:8081/` |
37+
| Physical LAN device | `make mobile` | `http://<HOST_LAN_IP>:8081/` |
3438

35-
Detection uses `ipconfig` on macOS and `ip route` on Linux. On native Windows — or any machine where detection fails — pass it explicitly:
39+
IP detection uses `ipconfig` on macOS and `ip route` on Linux. On native Windows — or any machine where detection fails — pass it explicitly:
3640

3741
```sh
38-
make local HOST_LAN_IP=192.168.1.50
42+
make mobile HOST_LAN_IP=192.168.1.50
3943
```
4044

4145
When your LAN IP changes (new wifi, tethering, etc.), update the running stack without a full rebuild:
@@ -44,6 +48,8 @@ When your LAN IP changes (new wifi, tethering, etc.), update the running stack w
4448
make refresh-urls
4549
```
4650

51+
Switching between `make local` and `make mobile` on an already-started stack is supported — both targets re-apply the correct URLs and trusted domains on each run.
52+
4753
#### Building changes:
4854

4955
- Enter the container with `docker compose exec eo bash`

0 commit comments

Comments
 (0)