wiki/applications/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

```
#!/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:

```
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'
```