Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #730

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,3 +153,48 @@ npm run build
```

Then your dashboard is ready to use in the `/dist` directory.

### Alpine VM/Container
Install homer on Alpine and serve with Nginx:
```sh
# update
apk update

# install nginx (webserver) + nano (editor)
apk add nginx nano

# create wwwserver user (make up a password when asked)
adduser -g 'Nginx www user' -h /home/www/ wwwserver

# replace default web server config with this content:
nano /etc/nginx/http.d/default.conf

# File contents (replace all of default.conf with this):
server {
# server ip/port
listen 80 default_server;

# virtual server name i.e. domain name
# server_name _;

# document root
root /var/www;

# log files
access_log /var/log/nginx/default.access.log;
error_log /var/log/nginx/default.access.error.log;
}

# start nginx and enable on boot
rc-service nginx start
rc-update add nginx default

# fetch homer source and unpack to /var/www/
wget https://github.com/bastienwirtz/homer/releases/latest/download/homer.zip
unzip homer.zip -d /var/www
cd /var/www

# create initial config, then edit
cp assets/config.yml.dist assets/config.yml
nano assets/config.yml
```