wiki/wiki/homer.md

# Homer

## Setup Server

### Docker

The official container and documentation was made by [b4bz](https://hub.docker.com/r/b4bz/homer).

#### Volumes

Set the following volumes with the -v tag.

| Volume-Name               | Container mount   | Description                        |
| ------------------------- | ----------------- | ---------------------------------- |
| `/current/dir/config.yml` | `/www/config.yml` | configuration file for static page |
| `homer`                   | `/www/assets`     | storage for icons, etc             |

#### Ports

Set the following ports with the -p tag.

| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| `8080`         | `8080`                   | TCP      | WebUI       |

#### Rebuild

```shell
#!/bin/sh
docker stop homer
docker rm homer
docker pull b4bz/homer:latest
docker run --name homer \
    --restart unless-stopped \
    -p 8080:8080 \
    -v /root/docker/homer/config.yml:/www/config.yml \
    -v homer:/www/assets \
    -d b4bz/homer:latest
```

#### Configuration

This is a sample config.yml:

```yml
title: "tmp"
subtitle: "tmp"
logo: "tmp"
footer: ""

message:
  style: ""
  title: "tmp"
  content: "tmp"

links:
  - name: "tmp"
    icon: "tmp"
    url: "tmp"
    target: "_blank"

services:
  - name: "tmp"
    icon: "tmp"
    items:
      - name: "tmp"
        logo: "tmp"
        subtitle: "tmp"
        tag: "tmp"
        url: "tmp"
        target: "_blank"
```