summaryrefslogtreecommitdiff
path: root/Installation-Guide.md
diff options
context:
space:
mode:
authorsupahgreg <supahgreg@users.noreply.github.com>2025-10-07 20:42:48 +0000
committersupahgreg <supahgreg@users.noreply.github.com>2025-10-07 20:42:48 +0000
commit0c3be9088c3156a4e9a6c3a8490577244dd7076d (patch)
treea5052f1c2b8a0cdc4144d8edf70ab78704d541f0 /Installation-Guide.md
parentfa346911a1e68fbc75cfdb93483e74e2be2d1e29 (diff)
Replace Docker Compose v1 references, update PHP binary references.
Diffstat (limited to 'Installation-Guide.md')
-rw-r--r--Installation-Guide.md19
1 files changed, 10 insertions, 9 deletions
diff --git a/Installation-Guide.md b/Installation-Guide.md
index ffbf5c4..4aebd8b 100644
--- a/Installation-Guide.md
+++ b/Installation-Guide.md
@@ -150,7 +150,7 @@ volumes:
### Your Docker images won't run on X!
If you're using an OS or architecture that isn't currently supported you'll likely need to
-build your own Docker images by using an override and running `docker-compose build`.
+build your own Docker images by using an override and running `docker compose build`.
```yaml
# docker-compose.override.yml
@@ -241,10 +241,11 @@ services:
### I'm trying to run CLI tt-rss scripts inside the container and they complain about root
-(run in the compose script directory)
+In your Docker Compose directory, run something like one of the examples below.
+Check https://github.com/tt-rss/tt-rss/blob/main/.docker/app/Dockerfile for the latest image's PHP version.
```sh
-docker-compose exec --user app app php8 /var/www/html/tt-rss/update.php --help
+docker compose exec --user app app php84 /var/www/html/tt-rss/update.php --help
# ^ ^
# | |
@@ -255,13 +256,13 @@ docker-compose exec --user app app php8 /var/www/html/tt-rss/update.php --help
or
```sh
-docker-compose exec app sudo -Eu app php8 /var/www/html/tt-rss/update.php --help
+docker compose exec app sudo -Eu app php84 /var/www/html/tt-rss/update.php --help
```
or
```sh
-docker exec -it <container_id> sudo -Eu app php8 /var/www/html/tt-rss/update.php --help
+docker exec -it <container_id> sudo -Eu app php84 /var/www/html/tt-rss/update.php --help
```
Note: `sudo -E` is needed to keep environment variables.
@@ -299,7 +300,7 @@ Copy and/or git clone any third party plugins into ``plugins.local`` as usual.
First, check that all containers are running:
```
-$ docker-compose ps
+$ docker compose ps
Name Command State Ports
------------------------------------------------------------------------------------------------------------
ttrss-docker-demo_app_1_f49351cb24ed /bin/sh -c /startup.sh Up 9000/tcp
@@ -312,7 +313,7 @@ ttrss-docker-demo_web-nginx_1_fcef07eb5c55 /docker-entrypoint.sh ngin ... Up
Then, ensure that frontend (`web-nginx` or `web`) container is up and can contact FPM (`app`) container:
```
-$ docker-compose exec web-nginx ping app
+$ docker compose exec web-nginx ping app
PING app (172.18.0.3): 56 data bytes
64 bytes from 172.18.0.3: seq=0 ttl=64 time=0.144 ms
64 bytes from 172.18.0.3: seq=1 ttl=64 time=0.128 ms
@@ -424,7 +425,7 @@ If you value your data, you should invest your time into setting up something li
The process to restore the database from a `backups` container backup might look like this:
-1. Enter `backups` container shell: `docker-compose exec backups /bin/sh`
+1. Enter `backups` container shell: `docker compose exec backups /bin/sh`
2. Inside the container, locate and choose the backup file: `ls -t /backups/*.sql.gz`
3. Clear database (**THIS WOULD DELETE EVERYTHING IN THE DB**): `psql -h db -U $TTRSS_DB_USER $TTRSS_DB_NAME -e -c "drop schema public cascade; create schema public"`
3. Restore the backup: `zcat /backups/ttrss-backup-yyyymmdd.sql.gz | psql -h db -U $TTRSS_DB_USER $TTRSS_DB_NAME`
@@ -433,7 +434,7 @@ Alternatively, if you want to initiate backups from the host, you can use someth
```sh
source .env
-docker-compose exec db /bin/bash \
+docker compose exec db /bin/bash \
-c "export PGPASSWORD=$TTRSS_DB_PASS \
&& pg_dump -U $TTRSS_DB_USER $TTRSS_DB_NAME" \
| gzip -9 > backup.sql.gz