logo

pleroma

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

release_to_docker_en.md (1764B)

    

  1. # Running OTP releases via Docker (glibc shim)
  3. Pleroma OTP releases are built on specific distros. If your host OS is older than
  4. the build environment, you may hit runtime linker errors such as:
  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 config and data directories.
  14. This approach uses a small "shim" container image to provide a newer `glibc`.
  15. It is **not** the official Pleroma Docker image.
  17. ## Requirements
  19. - Docker Engine + the Docker Compose plugin on the host
  20. - Root access (or equivalent access to the Docker socket)
  21. - Existing OTP release in `/opt/pleroma`
  22. - Existing config in `/etc/pleroma` and data in `/var/lib/pleroma`
  24. ## Setup
  26. 1. Copy the provided templates:
  28.    ```sh
  29.    mkdir -p /etc/pleroma/container
  30.    cp -a /opt/pleroma/installation/release-to-docker/* /etc/pleroma/container/
  31.    ```
  33. 2. Build the shim image:
  35.    ```sh
  36.    cd /etc/pleroma/container
  37.    docker compose build
  38.    ```
  40. 3. Replace your systemd unit:
  42.    ```sh
  43.    cp /etc/pleroma/container/pleroma.service /etc/systemd/system/pleroma.service
  44.    systemctl daemon-reload
  45.    systemctl enable --now pleroma
  46.    journalctl -u pleroma -f
  47.    ```
  49. ## Running migrations / `pleroma_ctl`
  51. Migrations are run automatically by default when the container starts. You can
  52. disable this by setting `PLEROMA_RUN_MIGRATIONS=0` in
  53. `/etc/pleroma/container/docker-compose.yml`.
  55. To run admin commands inside the container:
  57. ```sh
  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. ```