1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
# Run a JackTrip Server in a Container
Copyright (c) 2023-2024 JackTrip Labs, Inc.
See [MIT License](../../LICENSES/MIT.txt)
This repository provides the source code for building a container image to
run your own JackTrip hub server. It uses the
[Jack base container](https://github.com/jacktriplabs/jack-container)
and runs the [Jack Audio Connection Kit](https://jackaudio.org/)
(`jackd`) and JackTrip servers as systemd services. The `jackd` server
is configued to use the `dummy` audio backend so that no audio interface
is required.
New container images are built automatically for each release of JackTrip
and made freely available on
[Docker Hub](https://hub.docker.com/repository/docker/jacktrip/jacktrip/general).
To build a container image using `podman`:
```bash
podman build -t jacktrip/jacktrip .
```
To run a JackTrip container using `podman`:
```bash
podman run --name jacktrip --network=host --shm-size=128M -d jacktrip/jacktrip
```
`jackd` requires the ability to lock about 128MB of shared memory, and
both `jackd` and `jacktrip` will try to run realtime priority threads.
Be sure that your memory limits (`ulimit`) are set appropriately.
```
ulimit -l 128000000
ulimit -r 10
```
If using `docker`, you will need to run this as a privileged container:
```bash
docker run --name jacktrip --network=host --shm-size=128M --privileged -d jacktrip/jacktrip
```
Docker Desktop users on Mac and Windows computers may prefer to specify
a port range instead of using host networking:
```bash
docker run --name jacktrip -p 4464:4464/tcp -p 61000-61100:61000-61100/udp --shm-size=128M --privileged -d jacktrip/jacktrip
```
By default, the servers will run using a sample rate of 48Khz and buffer
size of 128. You can override these using the following environment
variables:
* __SAMPLE_RATE__: use this to set the sample rate for the `jackd` server.
Note that all clients connecting to the server must use the same setting.
The default is 48000.
* __BUFFER_SIZE__: use this to set the buffer size, also known as frames
per period, for the `jackd` server. The default is 128.
* __JACK_OPTS__: use this to override all of the options passed to the
`jackd` server. __SAMPLE_RATE__ and __BUFFER_SIZE__ will be ignored
if this is defined.
* __JACKTRIP_OPTS__: use this to override all of the options passed to the
`jacktrip` server. The default options are:
`-S -t -z --hubpatch 4 --bufstrategy 4 -q auto`
|
