135 lines
3.3 KiB
Markdown
135 lines
3.3 KiB
Markdown
# Mealie in docker
|
|
|
|
###### guide-by-example
|
|
|
|
|
|
|
|
# Purpose & Overview
|
|
|
|
Recipe cookbook.
|
|
|
|
* [The official site](https://hay-kot.github.io/mealie/)
|
|
* [Github](https://github.com/hay-kot/mealie)
|
|
* [DockerHub](https://hub.docker.com/r/hkotel/mealie)
|
|
|
|
Mealie is a simple, open source, self hosted cookbook.<br>
|
|
Written in python and javascript, using Vue framework for frontend.
|
|
It stores recipies in plain json as well as sqlite database.
|
|
|
|
# Files and directory structure
|
|
|
|
```
|
|
/home/
|
|
└── ~/
|
|
└── docker/
|
|
└── bookstack/
|
|
├── 🗁 mealie_data/
|
|
├── 🗋 .env
|
|
└── 🗋 docker-compose.yml
|
|
```
|
|
|
|
* `mealie_data/` - a directory with persistent data and backups
|
|
* `.env` - a file containing environment variables for docker compose
|
|
* `docker-compose.yml` - a docker compose file, telling docker how to run the containers
|
|
|
|
Only the files are required. The directory is created on the first run.
|
|
|
|
# docker-compose
|
|
|
|
The official documentation compose example
|
|
[here.](https://hay-kot.github.io/mealie/documentation/getting-started/install/#docker-compose-with-sqlite)
|
|
|
|
`docker-compose.yml`
|
|
```yml
|
|
services:
|
|
|
|
mealie:
|
|
image: hkotel/mealie
|
|
container_name: mealie
|
|
hostname: mealie
|
|
restart: unless-stopped
|
|
env_file: .env
|
|
expose:
|
|
- "80"
|
|
volumes:
|
|
- ./mealie_data/:/app/data
|
|
|
|
networks:
|
|
default:
|
|
name: $DOCKER_MY_NETWORK
|
|
external: true
|
|
```
|
|
|
|
`.env`
|
|
```bash
|
|
# GENERAL
|
|
DOCKER_MY_NETWORK=caddy_net
|
|
TZ=Europe/Bratislava
|
|
|
|
# MEALIE
|
|
PUID=1000
|
|
PGID=1000
|
|
RECIPE_PUBLIC=true
|
|
RECIPE_SHOW_NUTRITION=true
|
|
RECIPE_SHOW_ASSETS=true
|
|
RECIPE_LANDSCAPE_VIEW=true
|
|
RECIPE_DISABLE_COMMENTS=false
|
|
RECIPE_DISABLE_AMOUNT=false
|
|
```
|
|
|
|
**All containers must be on the same network**.</br>
|
|
Which is named in the `.env` file.</br>
|
|
If one does not exist yet: `docker network create caddy_net`
|
|
|
|
# Reverse proxy
|
|
|
|
Caddy v2 is used, details
|
|
[here](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/caddy_v2).</br>
|
|
|
|
`Caddyfile`
|
|
```php
|
|
book.{$MY_DOMAIN} {
|
|
reverse_proxy mealie:80
|
|
}
|
|
```
|
|
|
|
# First run
|
|
|
|
Default login: `changeme@email.com` // `MyPassword`
|
|
|
|
---
|
|
|
|
|
|
|
|
# New version incomig
|
|
|
|
There is a new version in work, v1.0.0 is already in beta5,
|
|
but it seems a major changes are introduced and theres not yet feature to
|
|
share recipies with people without password.
|
|
|
|
# Update
|
|
|
|
Manual image update:
|
|
|
|
- `docker-compose pull`</br>
|
|
- `docker-compose up -d`</br>
|
|
- `docker image prune`
|
|
|
|
It is **strongly recommended** to now add current **tags** to the images in the compose.<br>
|
|
Tags will allow you to easily return to a working state if an update goes wrong.
|
|
|
|
# Backup and restore
|
|
|
|
#### Backup
|
|
|
|
Using [kopia](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/kopia_backup)
|
|
or [borg](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/borg_backup)
|
|
to make daily snapshot of the entire docker directory.
|
|
|
|
#### Restore
|
|
|
|
* down the containers `docker-compose down`</br>
|
|
* delete/move/rename the entire project directory</br>
|
|
* from the backups copy back the entire project directory</br>
|
|
* start the containers `docker-compose up -d`
|