Vikunja

Upstream source: Current installation guide. The official image uses SQLite at /db/vikunja.db by default and stores uploads in /app/vikunja/files. Both paths need persistent volumes. SQLite is suitable for a small installation; use PostgreSQL or MySQL for a larger team.

Towbar manifest

.towbar/services/vikunja.service.yml

id: vikunja
name: Vikunja
buildServer: null
deployment:
  type: image
  image: vikunja/vikunja@sha256:417ada6f94e81f0267aa2f007d0a811fc82d38dd2aa58351e3ea520ca01c2ea5
container:
  port: 3456
  volumes:
    - name: db
      mountPath: /db
      initialData: image
    - name: files
      mountPath: /app/vikunja/files
      initialData: image
environments:
  production:
    server: 192.0.2.10
rollout:
  type: recreate
  maintenanceMode: true
  reason: Persistent application data uses a single writer
secrets:
  runtime:
    - VIKUNJA_SERVICE_SECRET
    - VIKUNJA_SERVICE_PUBLICURL
domains:
  primary: vikunja.example.com
tls:
  mode: direct

Configure

Prepare the example server, connect the repository, and map production to the branch containing these manifests. Replace the example server IP and domain. Commit the manifests, then sync the repository and inspect the resolved configuration.
Set the Service’s declared runtime values under Service → Settings → Secrets using the table below. Replace descriptions and placeholders with actual values; do not commit passwords or keys.
Keep the Service’s named volumes attached across deployments. Towbar’s Datastore backup policy does not back up Service volumes, so include them in your own recovery plan.
Deploy the Service, then perform the checks below before enabling auto-deploy.

Runtime values

Save these values on the Service after the repository sync. The manifest declares required keys, not their values.

Key	Value to save
`VIKUNJA_SERVICE_SECRET`	Generate a long random signing key and keep it stable.
`VIKUNJA_SERVICE_PUBLICURL`	https://vikunja.example.com/

Verify

Create a project and task, attach a file, and verify all three survive redeployment. If the database cannot be opened, check that the container’s UID 1000 can write to both volumes. For field constraints, see Service manifest.

Start here

Open-source software

Service recipes

Datastore recipes

Complete stacks

Towbar manifest

Configure

Runtime values

Verify

​Towbar manifest

​Configure

​Runtime values

​Verify

Towbar manifest

Configure

Runtime values

Verify