Skip to content

Commit faf9bf3

Browse files
committed
Update MANUAL_INSTALL.md with integration test note
Add note about Firefox and WebGL requirement for integration tests.
1 parent 5a7e994 commit faf9bf3

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

doc/MANUAL_INSTALL.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,20 @@ sudo apt-get install ruby ruby-dev ruby-bundler \
2727
sudo npm install --global yarn
2828
```
2929

30+
Running tests requires Firefox and WebGL support
31+
32+
```bash
33+
sudo apt-get install firefox mesa-utils libosmesa6 xvfb
34+
```
35+
36+
Firefox will be installed with snap and you will need to add
37+
38+
```
39+
system_test_firefox_binary: /snap/firefox/current/usr/lib/firefox/firefox
40+
```
41+
42+
to config/settings/test.local.yml
43+
3044
> [!TIP]
3145
> On Ubuntu 26.04, you may need to start PostgreSQL:
3246
>
@@ -211,6 +225,13 @@ This test will take a few minutes, reporting tests run, assertions, and any erro
211225

212226
> [!NOTE]
213227
> The unit tests may output parser errors related to "Attribute lat redefined." These can be ignored.
228+
>
229+
> For the tests that use WebGL to complete successfully on an headless machine you need to start an X server rendering on the virtual framebuffer
230+
> an easy way to do that is to use the docker entrypoint script
231+
>
232+
> ```bash
233+
> docker/entrypoint.sh bundle exec rails test:all
234+
> ```
214235
215236
### Starting the server
216237

0 commit comments

Comments
 (0)