[docs] Improve podman guide

- Create the `$HOME/.config/containers/systemd` dir if it doesn't
  already exists
- Fix the copy command for podman services
- Call `systemctl --user daemon-reload` to reload services before
  starting them.
This commit is contained in:
Norm 2024-02-25 14:24:28 -05:00
parent ef66626c43
commit 9ac99d9f86

View File

@ -13,7 +13,8 @@ If you want to use prebuilt images:
```sh ```sh
GIT_LFS_SKIP_SMUDGE=1 git clone https://iceshrimp.dev/iceshrimp/iceshrimp.git --depth=1 GIT_LFS_SKIP_SMUDGE=1 git clone https://iceshrimp.dev/iceshrimp/iceshrimp.git --depth=1
cp "iceshrimp/docs/examples/Podman (quadlet)" $HOME/.config/containers/systemd mkdir -p $HOME/.config/containers/systemd
cp "iceshrimp/docs/examples/Podman (quadlet)"/* $HOME/.config/containers/systemd
``` ```
Tweak quadlet files and change the image tag in `$HOME/.config/containers/systemd/iceshrimp-web.container` from `latest` to `dev` or `pre` if desired, and run `docs/examples/Podman\ \(quadlet\)/volume-dir-creation.sh`. Tweak quadlet files and change the image tag in `$HOME/.config/containers/systemd/iceshrimp-web.container` from `latest` to `dev` or `pre` if desired, and run `docs/examples/Podman\ \(quadlet\)/volume-dir-creation.sh`.
@ -23,7 +24,8 @@ If you want to build your own images:
```sh ```sh
git lfs install git lfs install
git clone https://iceshrimp.dev/iceshrimp/iceshrimp.git git clone https://iceshrimp.dev/iceshrimp/iceshrimp.git
cp "iceshrimp/docs/examples/Podman (quadlet)" $HOME/.config/containers/systemd mkdir -p $HOME/.config/containers/systemd
cp "iceshrimp/docs/examples/Podman (quadlet)"/* $HOME/.config/containers/systemd
``` ```
@ -45,6 +47,7 @@ Choose a method, whether you chose to build the image yourself or not.
```sh ```sh
podman pull $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2) podman pull $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2)
systemctl --user daemon-reload
systemctl --user start iceshrimp-web.service systemctl --user start iceshrimp-web.service
``` ```
@ -54,6 +57,7 @@ Enter Iceshrimp repo and run:
```sh ```sh
podman build . -t $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2) --ulimit nofile=16384:16384 podman build . -t $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2) --ulimit nofile=16384:16384
systemctl --user daemon-reload
systemctl --user start iceshrimp-web.service systemctl --user start iceshrimp-web.service
``` ```
@ -85,4 +89,4 @@ systemctl --user restart iceshrimp-web.service
If you are running Iceshrimp on a system with more than one CPU thread, you might want to set the `clusterLimit` config option to about half of your thread count, depending on your system configuration. Please note that each worker requires around 10 PostgreSQL connections, so be sure to set `max_connections` appropriately. To do this, change `max_connections=n` line in `db/postgresql.conf`, with `n` being `(10 * no_workers) + 10`, and run `systemctl --user restart iceshrimp-db iceshrimp-web`. If you are running Iceshrimp on a system with more than one CPU thread, you might want to set the `clusterLimit` config option to about half of your thread count, depending on your system configuration. Please note that each worker requires around 10 PostgreSQL connections, so be sure to set `max_connections` appropriately. To do this, change `max_connections=n` line in `db/postgresql.conf`, with `n` being `(10 * no_workers) + 10`, and run `systemctl --user restart iceshrimp-db iceshrimp-web`.
See also [post-install](post-install.md). See also [post-install](post-install.md).