mirror of
https://iceshrimp.dev/limepotato/jormungandr-bite.git
synced 2024-11-24 10:57:30 -07:00
[docs] Add podman (quadlet/systemd) installation guide
Co-authored-by: Jeder <jeder+git@jeder.pl> Co-committed-by: Jeder <jeder+git@jeder.pl>
This commit is contained in:
parent
0a3fedfd4f
commit
299a20fb71
6 changed files with 157 additions and 0 deletions
14
docs/examples/Podman (quadlet)/iceshrimp-db.container
Normal file
14
docs/examples/Podman (quadlet)/iceshrimp-db.container
Normal file
|
@ -0,0 +1,14 @@
|
|||
[Unit]
|
||||
Description=Iceshrimp PostgreSQL container
|
||||
[Container]
|
||||
Image=docker.io/postgres:15-alpine
|
||||
ContainerName=iceshrimp_db
|
||||
HostName=db
|
||||
Network=iceshrimp.network
|
||||
EnvironmentFile=%h/services/iceshrimp/.config/docker.env
|
||||
Volume=%h/services/iceshrimp/db:/var/lib/postgresql/data:Z
|
||||
[Service]
|
||||
Restart=on-failure
|
||||
TimeoutStartSec=900
|
||||
[Install]
|
||||
WantedBy=iceshrimp-web.service
|
14
docs/examples/Podman (quadlet)/iceshrimp-redis.container
Normal file
14
docs/examples/Podman (quadlet)/iceshrimp-redis.container
Normal file
|
@ -0,0 +1,14 @@
|
|||
[Unit]
|
||||
Description=Iceshrimp Redis container
|
||||
[Container]
|
||||
Image=docker.io/redis:7.0-alpine
|
||||
ContainerName=iceshrimp_redis
|
||||
HostName=redis
|
||||
Network=iceshrimp.network
|
||||
Volume=%h/services/iceshrimp/redis:/data:Z
|
||||
[Service]
|
||||
Restart=on-failure
|
||||
TimeoutStartSec=900
|
||||
[Install]
|
||||
WantedBy=iceshrimp-web.service
|
||||
|
16
docs/examples/Podman (quadlet)/iceshrimp-web.container
Normal file
16
docs/examples/Podman (quadlet)/iceshrimp-web.container
Normal file
|
@ -0,0 +1,16 @@
|
|||
[Unit]
|
||||
Description=Iceshrimp container
|
||||
[Container]
|
||||
Image=iceshrimp.dev/iceshrimp/iceshrimp:latest
|
||||
ContainerName=iceshrimp_web
|
||||
HostName=web
|
||||
PublishPort=3000:3000
|
||||
Network=iceshrimp.network
|
||||
Environment=NODE_ENV=production
|
||||
Volume=%h/services/iceshrimp/files:/iceshrimp/files:z
|
||||
Volume=%h/services/iceshrimp/.config:/iceshrimp/.config:ro,z
|
||||
[Service]
|
||||
Restart=on-failure
|
||||
TimeoutStartSec=900
|
||||
[Install]
|
||||
WantedBy=multi-user.target default.target
|
1
docs/examples/Podman (quadlet)/iceshrimp.network
Normal file
1
docs/examples/Podman (quadlet)/iceshrimp.network
Normal file
|
@ -0,0 +1 @@
|
|||
[Network]
|
24
docs/examples/Podman (quadlet)/volume-dir-creation.sh
Executable file
24
docs/examples/Podman (quadlet)/volume-dir-creation.sh
Executable file
|
@ -0,0 +1,24 @@
|
|||
#!/bin/bash
|
||||
if [ -d $HOME/.config/containers/systemd ]; then
|
||||
mkdir -pv $(grep -F "Volume=" $HOME/.config/containers/systemd/iceshrimp-*.container | sed "s|%h|$HOME|g" | cut -d= -f2 | cut -d: -f1);
|
||||
|
||||
db_env=$(grep -F "EnvironmentFile=" $HOME/.config/containers/systemd/iceshrimp-db.container | sed "s|%h|$HOME|g" | cut -d= -f2)
|
||||
config_dir=$(grep -F ":/iceshrimp/.config" $HOME/.config/containers/systemd/iceshrimp-web.container | sed "s|%h|$HOME|g" | cut -d= -f2 | cut -d: -f1)
|
||||
|
||||
if [ ! -f $config_dir/docker_example.env ]; then
|
||||
wget -O $db_env \
|
||||
https://iceshrimp.dev/iceshrimp/iceshrimp/raw/branch/dev/.config/docker_example.env;
|
||||
else
|
||||
cp -v $config_dir/docker_example.env $db_env;
|
||||
fi
|
||||
|
||||
if [ ! -f $config_dir/example-docker.yml ]; then
|
||||
wget -O $config_dir/default.yml \
|
||||
https://iceshrimp.dev/iceshrimp/iceshrimp/raw/branch/dev/.config/example-docker.yml;
|
||||
else
|
||||
cp $config_dir/example-docker.yml $config_dir/default.yml
|
||||
fi
|
||||
else
|
||||
echo "No $HOME/.config/containers/systemd found"
|
||||
exit 1
|
||||
fi
|
88
docs/podman-install.md
Normal file
88
docs/podman-install.md
Normal file
|
@ -0,0 +1,88 @@
|
|||
# Installing Iceshrimp using Podman and Quadlet
|
||||
Quadlet is a feature of Podman that is kind of like Docker Compose, but is better integrated with systemd, just like whole Podman.
|
||||
|
||||
## Requirements
|
||||
- Podman 4.4+ with aardvark
|
||||
- Git with LFS installed (if building your own images)
|
||||
|
||||
## Preparations
|
||||
|
||||
### Getting needed files
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
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`.
|
||||
|
||||
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
|
||||
|
||||
```
|
||||
|
||||
Tweak quadlet files if needed, change content of `Image:` line in `$HOME/.config/containers/systemd/iceshrimp-web.container` to `Image: localhost/iceshrimp/iceshrimp:latest`, and run `docs/examples/Podman\ \(quadlet\)/volume-dir-creation.sh`.
|
||||
|
||||
### .config
|
||||
|
||||
Edit `.config/docker.env` and fill it with the database credentials you want.
|
||||
Edit `.config/default.yml` and:
|
||||
|
||||
- Replace example database credentials with the ones you entered in `.config/docker.env`
|
||||
- Change other configuration
|
||||
|
||||
## Installation and first start
|
||||
|
||||
Choose a method, whether you chose to build the image yourself or not.
|
||||
|
||||
### Pulling the image
|
||||
|
||||
```sh
|
||||
podman pull $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2)
|
||||
systemctl --user start iceshrimp-web.service
|
||||
```
|
||||
|
||||
### Building the image
|
||||
|
||||
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 start iceshrimp-web.service
|
||||
```
|
||||
|
||||
## Starting Iceshrimp automatically
|
||||
|
||||
Run `sudo loginctl enable-linger [user]` and Iceshrimp will start automatically on boot. You don't need to, and in fact [cannot enable Podman-generated systemd services](https://man.archlinux.org/man/extra/podman/podman-systemd.unit.5.en#Enabling_unit_files).
|
||||
|
||||
## Updating Iceshrimp
|
||||
|
||||
### Pulling the image
|
||||
|
||||
```sh
|
||||
podman pull $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2)
|
||||
systemctl --user restart iceshrimp-web.service
|
||||
```
|
||||
|
||||
### Building the image
|
||||
|
||||
```sh
|
||||
## Run git stash commands only if you have uncommitted changes
|
||||
git stash
|
||||
git pull
|
||||
git stash pop
|
||||
podman build . -t $(grep -F "Image=" $HOME/.config/containers/systemd/iceshrimp-web.container | cut -d= -f2) --ulimit nofile=16384:16384
|
||||
systemctl --user restart iceshrimp-web.service
|
||||
```
|
||||
|
||||
## Post-install
|
||||
|
||||
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).
|
Loading…
Reference in a new issue