Vikunja

Vikunja is a to-do app.

Preparation

Set up passwords and other variables in your host_vars/YOURSERVER/main.yml and host_vars/YOURSERVER/vault.yml for vikunja databases, vikunja email address, account etc

Installation

Run the role, optionally limiting it to a server.

ansible-playbook --ask-vault-pass --limit YOURSERVER play/app/vikunja.yml

You should be able to reach Vikunja at https://vikunja.YOUR-FQDN but you’ll need to create an account before you can log in, see below.

Adding Vikunja user accounts

There is no web UI in Vikunja for managing users and Momod doesn’t enable user registration in the Vikunja Frontend (because we don’t want to allow everyone on the internet to create accounts on our instance).

The only way to add users is via the Vikunja CLI. To add a user account ssh to the server, switch to the vikunja user and run the command in the API container. For a user ‘alice’ with password ‘password123’ and email address of user@example.com ssh into the server and do:

sudo su - vikunja
podman exec container-vikunja-api /bin/sh -c './vikunja user create --email user@example.com -u alice -p password123'

See the Vikunja CLI documentation for more details including how to delete users.

Enable Vikunja on Momod Dashboard

This is optional, if you want the Vikunja link to work on Momod Dashboard set the app_vikunja variable in your host_vars to ’enabled’:

app_radicale: "enabled"

And run the homer play:

ansible-playbook --limit YOURSERVER play/app/homer.yml