1
Fork 0
mirror of https://github.com/jech/galene.git synced 2024-11-09 18:25:58 +01:00

Tweak installation instructions.

This commit is contained in:
Juliusz Chroboczek 2022-10-21 13:56:11 +02:00
parent 16e2888d56
commit 526ec594b5

32
INSTALL
View file

@ -1,6 +1,17 @@
# Installation instructions # Installation instructions
## Build the `galene` binary ## Quick installation
CGO_ENABLED=0 go build -ldflags='-s -w'
mkdir groups
echo '{"presenter": [{}]}' > groups/test.json
./galene &
Then connect to `https://localhost:8443` and choose "test".
## Full installation instructions
### Build the `galene` binary
You will need Go 1.16 or later (type `go version`). Then do: You will need Go 1.16 or later (type `go version`). Then do:
@ -12,7 +23,7 @@ On Windows, do
go build -ldflags="-s -w" go build -ldflags="-s -w"
## Set up a group ### Set up a group
Set up a group called *test* by creating a file `groups/test.json`: Set up a group called *test* by creating a file `groups/test.json`:
@ -29,7 +40,7 @@ You may use the following definition:
See the README file for more details about defining groups. See the README file for more details about defining groups.
## Test locally ### Test locally
./galene & ./galene &
@ -38,7 +49,7 @@ to the group that you have just set up in two distinct browser windows,
then press *Ready* in one of the two; you should see a video in the other. then press *Ready* in one of the two; you should see a video in the other.
## Configure your server's firewall ### Configure your server's firewall
If your server has a global IPv4 address and there is no firewall, there If your server has a global IPv4 address and there is no firewall, there
is nothing to do. is nothing to do.
@ -61,7 +72,7 @@ Galène's command line, where `203.0.113.1` is your NAT's external (global)
IPv4 address. IPv4 address.
## Cross-compile for your server ### Cross-compile for your server
This step is only required if your server runs a different OS or has This step is only required if your server runs a different OS or has
a different CPU than your build machine. a different CPU than your build machine.
@ -87,7 +98,7 @@ For a 32-bit MIPS board with no hardware floating point (WNDR3800, etc.):
CGO_ENABLED=0 GOOS=linux GOARCH=mips GOMIPS=softfloat go build -ldflags='-s -w' CGO_ENABLED=0 GOOS=linux GOARCH=mips GOMIPS=softfloat go build -ldflags='-s -w'
## Deploy to your server ### Deploy to your server
Set up a user *galene* on your server, then do: Set up a user *galene* on your server, then do:
@ -103,7 +114,8 @@ a certificate, install it in the files `data/cert.pem` and `data/key.pem`:
sudo chown galene:galene data/*.pem sudo chown galene:galene data/*.pem
sudo chmod go-rw data/key.pem sudo chmod go-rw data/key.pem
Now run the binary on the server: Now arrange to run the binary on the server. If you never reboot your
server, it might be as simple as
ssh galene@server.example.org ssh galene@server.example.org
ulimit -n 65536 ulimit -n 65536
@ -135,7 +147,7 @@ If you are using *systemd*:
WantedBy=multi-user.target WantedBy=multi-user.target
# ICE Servers # Connectivity issues and ICE Servers
Most connectivity issues are due to an incorrect ICE configuration. Most connectivity issues are due to an incorrect ICE configuration.
@ -197,8 +209,8 @@ look like this:
} }
] ]
If you prefer to use coturn's `use-auth-secret` option, then the It is more secure to use coturn's `use-auth-secret` option. If you do
`ice-servers.json` file should look like this: that, then the `ice-servers.json` file should look like this:
[ [
{ {