From 9ac99d9f867d6bca8568cdba8c4cebe9511c26df Mon Sep 17 00:00:00 2001 From: Norm Date: Sun, 25 Feb 2024 14:24:28 -0500 Subject: [PATCH] [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. --- docs/podman-install.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/podman-install.md b/docs/podman-install.md index 068d08af2..97dc289d4 100644 --- a/docs/podman-install.md +++ b/docs/podman-install.md @@ -13,7 +13,8 @@ If you want to use prebuilt images: ```sh 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`. @@ -23,7 +24,8 @@ If you want to build your own images: ```sh git lfs install 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 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 ``` @@ -54,6 +57,7 @@ Enter Iceshrimp repo and run: ```sh 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 ``` @@ -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`. -See also [post-install](post-install.md). \ No newline at end of file +See also [post-install](post-install.md).