54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
# Ansible Role: wikijs
|
|
|
|
This Ansible Role installs a rootless [wikijs](https://docs.requarks.io/guide/intro) container using Podman. It is intended to be composed with separate roles for Podman, database, and web proxy.
|
|
|
|
## Requirements
|
|
|
|
* [podman](docs/PODMAN.md)
|
|
* [containers.podman](https://github.com/containers/ansible-podman-collections)
|
|
|
|
## Dependencies
|
|
|
|
* [postgresql](docs/POSTGRES.md) (optional)
|
|
* [nginx_conf](docs/examples/nginx_conf.yml) (optional)
|
|
|
|
## Role Variables
|
|
|
|
See the role [defaults](defaults/main.yml) and the wikijs [environment variable](https://docs.requarks.io/install/docker) documentation. For a working example, see this [homelab stack](https://github.com/bleetube/satstack).
|
|
|
|
## Example Playbook
|
|
|
|
```yaml
|
|
- hosts: wikijs
|
|
roles:
|
|
- role: nginxinc.nginx_core.nginx
|
|
become: true
|
|
- role: anxs.postgresql
|
|
become: true
|
|
- role: alvistack.podman
|
|
become: true
|
|
- role: bleetube.wikijs
|
|
tags: wikijs
|
|
tasks:
|
|
- import_tasks: nginx_conf.yml
|
|
become: true
|
|
```
|
|
|
|
## Systemd
|
|
|
|
```
|
|
systemctl --user status container-wikijs.service
|
|
```
|
|
|
|
## Upgrades
|
|
|
|
Configure `wikijs_version`.
|
|
|
|
```bash
|
|
ansible-playbook playbooks/wikijs.yml --tags wikijs
|
|
```
|
|
|
|
## Backups
|
|
|
|
See the [postgres example](docs/examples/postgres-backup.sh).
|