Skip to content

Instruct user to create host mounted dirs first #146

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jeremyestein merged 3 commits into from
Dec 17, 2025
Merged

Instruct user to create host mounted dirs first #146

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9a96137
Instruct user to create host mounted dirs first
jeremyestein Dec 15, 2025
7103d41
Clarify directory creation
jeremyestein Dec 16, 2025
69ac8c3
Try and kick Github Actions.
jeremyestein Dec 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion docs/dev/deployment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,6 @@ Config tips:
- All config must stay local and not be committed to git.

### Clone the other repositories

> [!NOTE]
> Since moving to the monorepo, the importance of the `emap` script in managing repos
> has decreased. Especially during development, you may just want to manually manipulate your git repos.
Expand Down Expand Up @@ -223,6 +222,25 @@ vim global-configuration.yaml
emap setup -g
```

### Create host mounted directories

> [!NOTE]
> GAE only.

If you enabled any services which mount a host directory, then it's easier
to create that directory *before* you bring any services up.

Eg. for the waveform-reader:
```bash
mkdir /gae/emap-instance-name/waveform-saved-messages
```
Although docker compose will create any missing host directories, it
will use the wrong permissions and subsequently written files will need
fixing up before they can be read by normal users.
See Slab for the
[required chmod/chown/setfacl trick](https://uclh.slab.com/posts/shared-virtual-python-environments-with-uv-u7pa2fv4#hpkxd-per-gae-setup-tasks)
if you did this.

### Bringing up an instance
```bash
emap docker up -d
Expand Down