logo

pleroma

My custom branche(s) on git.pleroma.social/pleroma/pleroma git clone https://anongit.hacktivis.me/git/pleroma.git/

README.md (2027B)

    

  1. # Run OTP releases on older glibc using Docker
  3. Pleroma OTP releases are built on specific distros and may require a newer `glibc`
  4. than your host has. A typical failure looks like:
  6. ```
  7. ... /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found ...
  8. ```
  10. If you don't want to upgrade your host OS, you can run the existing OTP release
  11. from `/opt/pleroma` inside an Ubuntu 24.04 container while keeping your existing
  12. host paths (`/etc/pleroma`, `/var/lib/pleroma`, etc.).
  14. This folder provides a "shim" container + systemd unit. It is **not** the Pleroma
  15. Docker image.
  17. ## What this does
  19. - Builds a small Ubuntu 24.04 image with runtime libs (including newer `glibc`).
  20. - Mounts your existing host release at `/opt/pleroma` into the container.
  21. - Runs as the same UID/GID that owns `/opt/pleroma` on the host (via `gosu`).
  22. - Optionally runs migrations automatically on container start.
  23. - Uses `network_mode: host` so your existing config that talks to `localhost`
  24.   keeps working.
  26. ## Setup (Debian/Ubuntu host)
  28. 1. Install Docker Engine + the Docker Compose plugin.
  29. 2. Copy these files to a stable location (example: `/etc/pleroma/container`):
  31.    ```
  32.    mkdir -p /etc/pleroma/container
  33.    cp -a /opt/pleroma/installation/release-to-docker/* /etc/pleroma/container/
  34.    ```
  36. 3. Build the shim image:
  38.    ```
  39.    cd /etc/pleroma/container
  40.    docker compose build
  41.    ```
  43. 4. Replace your systemd unit:
  45.    ```
  46.    cp /etc/pleroma/container/pleroma.service /etc/systemd/system/pleroma.service
  47.    systemctl daemon-reload
  48.    systemctl enable --now pleroma
  49.    journalctl -u pleroma -f
  50.    ```
  52. ## Running `pleroma_ctl`
  54. Since the host binary may not run on older `glibc`, run admin commands inside the
  55. container:
  57. ```
  58. cd /etc/pleroma/container
  59. docker compose exec pleroma /opt/pleroma/bin/pleroma_ctl status
  60. docker compose run --rm --no-deps pleroma /opt/pleroma/bin/pleroma_ctl migrate
  61. ```
  63. ## Configuration notes
  65. - Migrations run automatically by default.
  66.   - Set `PLEROMA_RUN_MIGRATIONS=0` in `docker-compose.yml` to disable.