ami/tl-vikunja
1
0
Fork 0
Code
tl-vikunja/docs/content/doc/usage/cli.md
Dominik Pschenitschni aaa0593289 feat(docs): various improvements 
- removing spaces at end of line
- fixing spelling and grammar mistakes
- making sure 'Vikunja' is spelled the same way everywhere
- prefer using editors word wrap instead of hardcoding word wrap in markdown (reason: different word wrap per editor & end of line space)
- add newline add end where missing
- remove double colon at end of headlines
- remove unnecessary indention
- make sure code blocks and headlines etc always have an empty line around
2023-04-11 16:42:59 +00:00

4.5 KiB
Raw Blame History

date, title, draft, type, menu
date title draft type menu
2019-03-31:00:00+01:00 CLI false doc
sidebar
parent
usage

Command line interface

You can interact with Vikunja using its cli interface.
The following commands are available:

If you don't specify a command, the web command will be executed.

All commands use the same standard [config file]({{< ref "../setup/config.md">}}).

Using the cli in docker

When running Vikunja in docker, you'll need to execute all commands in the api container. Instead of running the vikunja binary directly, run it like this:

docker exec <name of the vikunja api container> /app/vikunja/vikunja <subcommand>

dump

Creates a zip file with all vikunja-related files. This includes config, version, all files and the full database.

Usage: {{< highlight bash >}} $ vikunja dump {{< /highlight >}}

help

Shows more detailed help about any command.

Usage:

{{< highlight bash >}} $ vikunja help [command] {{< /highlight >}}

migrate

Run all database migrations which didn't already run.

Usage: {{< highlight bash >}} $ vikunja migrate [flags] $ vikunja migrate [command] {{< /highlight >}}

migrate list

Shows a list with all database migrations.

Usage: {{< highlight bash >}} $ vikunja migrate list {{< /highlight >}}

migrate rollback

Roll migrations back until a certain point.

Usage: {{< highlight bash >}} $ vikunja migrate rollback [flags] {{< /highlight >}}

Flags:

  • -n, --name string: The id of the migration you want to roll back until.

restore

Restores a previously created dump from a zip file, see dump.

Usage: {{< highlight bash >}} $ vikunja restore {{< /highlight >}}

testmail

Sends a test mail using the configured smtp connection.

Usage: {{< highlight bash >}} $ vikunja testmail {{< /highlight >}}

user

Bundles a few commands to manage users.

user change-status

Enable or disable a user. Will toggle the current status if no flag (--enable or --disable) is provided.

Usage: {{< highlight bash >}} $ vikunja user change-status {{< /highlight >}}

Flags:

  • -d, --disable: Disable the user.
  • -e, --enable: Enable the user.

user create

Create a new user.

Usage: {{< highlight bash >}} $ vikunja user create {{< /highlight >}}

Flags:

  • -a, --avatar-provider: The avatar provider of the new user. Optional.
  • -e, --email: The email address of the new user.
  • -p, --password: The password of the new user. You will be asked to enter it if not provided through the flag.
  • -u, --username: The username of the new user.

user delete

Start the user deletion process. If called without the --now flag, this command will only trigger an email to the user in order for them to confirm and start the deletion process (this is the same behavoir as if the user requested their deletion via the web interface). With the flag the user is deleted immediately.

USE WITH CAUTION.

{{< highlight bash >}} $ vikunja user delete {{< /highlight >}}

Flags:

  • -n, --now If provided, deletes the user immediately instead of emailing them first.

user list

Shows a list of all users.

Usage: {{< highlight bash >}} $ vikunja user list {{< /highlight >}}

user reset-password

Reset a users password, either through mailing them a reset link or directly.

Usage: {{< highlight bash >}} $ vikunja user reset-password {{< /highlight >}}

Flags:

  • -d, --direct: If provided, reset the password directly instead of sending the user a reset mail.
  • -p, --password: The new password of the user. Only used in combination with --direct. You will be asked to enter it if not provided through the flag.

user update

Update an existing user.

Usage: {{< highlight bash >}} $ vikunja user update {{< /highlight >}}

Flags:

  • -a, --avatar-provider: The new avatar provider of the new user.
  • -e, --email: The new email address of the user.
  • -u, --username: The new username of the user.

version

Prints the version of Vikunja. This is either the semantic version (something like 0.7) or version + git commit hash.

Usage: {{< highlight bash >}} $ vikunja version {{< /highlight >}}

web

Starts Vikunja's REST api server.

Usage: {{< highlight bash >}} $ vikunja web {{< /highlight >}}