1
0
mirror of https://github.com/amir20/dozzle.git synced 2025-12-21 13:23:07 +01:00

docs: Add podman.md in docs, adjust readme.md/faq.md with host not found error documentation (#3407)

This commit is contained in:
Rhea Alleen
2024-11-19 18:31:56 +01:00
committed by GitHub
parent bd7f6bc886
commit 50855a8700
3 changed files with 68 additions and 0 deletions

45
docs/guide/podman.md Normal file
View File

@@ -0,0 +1,45 @@
---
title: Podman
---
## I am seeing host not found error in the logs. How do I fix it?
This should be mainly a Podman only error: Using Podman doesn't create an engine-id like Docker.
If you are using Docker check if the ```engine-id``` file exists with correct permissions in ```/var/lib/docker``` and has the UUID inside.
It might be neccessary to clean up your existing dozzle deployment under Podman, stop the container and remove the associated data (container/volumes). After you created the engine-id you can redeploy the Dozzle container and your logs should now show up.
## Create UUID
Options for generating UUIDs
### uuidgen
:warning: Adjust folder/file permissions if necessary. There isn't an critial info but depending on your existing setup you might want to take additional steps
1. Install uuidgen
2. Create the folders: ```mkdir -p /var/lib/docker```
3. Using uuidgen generate an UUID: ```uuidgen > /var/lib/docker/engine-id```
4. Verify with ```cat /var/lib/docker/engine-id```
### Ansible
:warning: Depending on your setup you might have to take adjustments for file/folder permissions. The following task snippets would run as the become_user of the playbook running these tasks.
If you wish to adjust the user have to set individual become/become_user parameters for the task.
```
- name: Create /var/lib/docker
ansible.builtin.file:
path: /var/lib/docker
state: directory
mode: '755'
- name: Create engine-id and derive UUID from hostname
ansible.builtin.lineinfile:
path: /var/lib/docker/engine-id
line: "{{ hostname | to_uuid }}"
create: true
mode: "0644"
insertafter: "EOF"
```