mirror of
https://github.com/iv-org/documentation.git
synced 2024-12-22 14:05:09 -05:00
Add new page: Community Installation Guide (#473)
* Create community-installation-guide * Update and rename community-installation-guide to community-installation-guide.md * Update community-installation-guide.md
This commit is contained in:
parent
c0ae387620
commit
fc5f83cb4e
101
docs/community-installation-guide.md
Normal file
101
docs/community-installation-guide.md
Normal file
@ -0,0 +1,101 @@
|
||||
# Community Installation Guide
|
||||
|
||||
After installation take a look at the [Post-install steps](installation.md#post-install-configuration).
|
||||
|
||||
## Podman (rootless container)
|
||||
|
||||
Podman is usually pre-installed in Fedora, CentOS, RHEL and derivatives. But if this is not the case, the instruction below will install all necessary packages.
|
||||
|
||||
RHEL based and RHEL-like systems
|
||||
```bash
|
||||
sudo dnf install podman
|
||||
```
|
||||
|
||||
### Download the configuration files from Invidious' repository
|
||||
|
||||
Note: Currently the repository has to be cloned, this is because the `init-invidious-db.sh` file and the `config/sql` directory have to be mounted to the postgres container (See the volumes section in the postgres' container). This "problem" will be solved in the future.
|
||||
> `<INV-PATH>` Absolute path in your home directory where invidious will be downloaded (e.i. /home/johnsmith/.inv)
|
||||
|
||||
```bash
|
||||
cd <INV-PATH>
|
||||
git clone https://github.com/iv-org/invidious.git
|
||||
```
|
||||
|
||||
### Create Pod - videos
|
||||
|
||||
```bash
|
||||
podman pod create --name videos -p 3000:3000
|
||||
```
|
||||
|
||||
### Create Container - postgres
|
||||
|
||||
```bash
|
||||
podman create --rm \
|
||||
--pod videos \
|
||||
--name postgres \
|
||||
--label "io.containers.autoupdate=registry" \
|
||||
--health-cmd='pg_isready -U $POSTGRES_USER -d $POSTGRES_DB' \
|
||||
-v postgresdata:/var/lib/postgresql/data \
|
||||
-v <INV-PATH>/invidious/config/sql:/config/sql:z \
|
||||
-v <INV-PATH>/invidious/docker/init-invidious-db.sh:/docker-entrypoint-initdb.d/init-invidious-db.sh:z \
|
||||
-e POSTGRES_DB=invidious \
|
||||
-e POSTGRES_USER=kemal \
|
||||
-e POSTGRES_PASSWORD=kemal \
|
||||
docker.io/library/postgres:14
|
||||
```
|
||||
|
||||
### Create Container - invidious
|
||||
|
||||
Copy `<INV-PATH>/invidious/config/config.example.yml` to `<INV-PATH>/config.yml` and update parameters as required.
|
||||
|
||||
```bash
|
||||
podman create --rm \
|
||||
--pod videos \
|
||||
--name invidious \
|
||||
--label "io.containers.autoupdate=registry" \
|
||||
--health-cmd="wget -nv --tries=1 --spider http://127.0.0.1:3000/api/v1/comments/jNQXAC9IVRw || exit 1" \
|
||||
--health-interval=30s \
|
||||
--health-timeout=5s \
|
||||
--health-retries=2 \
|
||||
-v <INV-PATH>/config.yml:/invidious/config/config.yml:z,U \
|
||||
quay.io/invidious/invidious:latest
|
||||
```
|
||||
|
||||
### Create systemd services to manage the Pod
|
||||
|
||||
Podman can generate systemd services to handle the life cycle of pods and containers.
|
||||
The instructions below will create 3 service units, and they will be placed in the correct location ready to be used.
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
cp $(podman generate systemd --new --files --name videos) .config/systemd/user
|
||||
```
|
||||
|
||||
### Start Pod
|
||||
|
||||
Despite the existance of 3 services, only the one related to the Pod must be used. The life cycle for the 2 containers implementing **postgres** and **invidious** will be handled by the pod.
|
||||
|
||||
```bash
|
||||
systemctl --user daemon-reload
|
||||
systemctl --user enable --now pod-videos.service
|
||||
```
|
||||
|
||||
And similarly, the instruction below will re-start the service:
|
||||
|
||||
```bash
|
||||
systemctl --user restart pod-videos.service
|
||||
```
|
||||
|
||||
If this service runs on a server, it will stop as soon as you logout, because it is running in user space.
|
||||
To ensure it is persistent and remains active after logging out, you will need to enable user lingering.
|
||||
|
||||
```bash
|
||||
loginctl enable-linger
|
||||
```
|
||||
|
||||
### Updating to the latest release
|
||||
|
||||
```bash
|
||||
podman auto-update
|
||||
podman image prune -f
|
||||
```
|
Loading…
Reference in New Issue
Block a user