Skip to main content
Jottacloud CLI Configuration

Learn to configure Jottacloud CLI to suit your needs

Updated over 2 months ago

jotta-cli config

Jottacloud CLI comes with several settings you can toggle or tune.

You can see a complete list of these settings and their values by calling:

> jotta-cli config get
downloadrate : unlimited
uploadrate : unlimited
checksumreadrate : 52.43MB/s
ignorehiddenfiles : false
maxuploads : 6
maxdownloads : 6
scaninterval : 1h0m0s
webhookstatusinterval : 6h0m0s
logscanignores : false
slowmomode : 0
logtransfers : false
screenshotscapture : false

The default settings are displayed above.

Download, upload, and checksum read rate

Changes the bandwidth jottad is allowed to consume when downloading/uploading. The units used to describe this should be fairly intuitive: 1m means 1Megabytes per second. 512k means 512 Kilobytes per second. 0 means unlimited.

The checksumming rate can also be set. It is limited by default to ensure the entire disk bandwidth is not used to checksum files in preparation for uploading. It can be set to unlimited if desired.

Max uploads and downloads

Allows the maximum allowed simultaneous uploads and downloads to be set. The lower bound is 1 and the upper bound is 6.

Scan interval

jottad scans each folder added to backup every scan interval.

The units are:

h for hour 
m for minutes
s for seconds

They can be combined or used alone as

jotta-cli config set scaninterval 30m
jotta-cli config set scaninterval 2h
jotta-cli config set scaninterval 1h30m

You can also set the scaninterval to 0. jottad will then run backups in realtime mode which uses triggers from the filesystem to determine what and when to perform backups.


Webhook status interval

If you have any webhooks configured jottad will post a status update to the webhook every webhook status interval. The units are as for scaninterval.

Ignore hidden files

When the config option ignorehiddenfiles is set to true, hidden files will be excluded from backup. On macOS, linux and freeBSD, files and folders starting with a period will be ignored .examplefilename. On Windows, files and folders with the attribute FILE_ATTRIBUTE_HIDDEN will be ignored.

With ignorehiddenfiles set to true, hidden files in archive will also be ignored unless they are specifically selected. This means if a folder containing a hidden file is archived, the hidden file is ignored. If a hidden folder or file is uploaded to archive directly, it is not ignored.

root_folder
- file1.txt
- file2.txt
- .file3.txt
- file4.txt

With the above example folder, when archiving root_folder by running jotta-cli archive root_folder, jottad would ignore .file3.txt and it is not uploaded to Archive. If you instead run jotta-cli archive root_folder/.file3.txt the file is uploaded, as it is specifically selected.

Log scan ignores

jottad will ignore some files when scanning. Either because jottad ignores all such files or because you may have added your own ignore rules. Setting logscanignores to true will cause jottad to write the reason for each file ignored to the logfile. You can use this to figure out why a particular file or folder was not updated.

Slowmo mode

jottad will by the default value of slomomode use all available cpu/harddrive resources when scanning. This can cause other processes to suffer. By setting slowmomode to a higher value scan will slow down a bit thus using less cpu/harddrive. The range of valid values is (0-50).

Log transfers

jottad by default only logs transfer errors. Setting this to true will cause jottad to write the result of all http requests related to upload/download to the logfile.


Screenshot capture on MacOS

Setting to true will cause jottad to watch for any screenshots taken, upload them and generate a public url which i written to your clipboard. It can be very useful for quickly sharing screenshots with other people.

Screenshot capture linux

While not as straight forward as on MacOS, it is possible to do this on linux as well.

Although there exists many tools on linux for screenshot capture, we recommend using maim for the best experience

Install maim and xclip with your package manager:

apt install maim xclip # apt/dpkg based
yum install maim xclip # rpm based


With this script we will spawn main to select the parts of your desktop you want to screenshot and then upload the screenshot to Jottacloud and generate a public share URL for it:

#!/bin/bash

set -euo pipefail

FILE=$(mktemp -t "screenshot-XXXXXX.png")
maim -suq ${FILE}
jotta-cli archive ${FILE} --remote=Screenshots/$(basename ${FILE}) --share --clipboard --nogui
rm ${FILE}

Save the script to somewhere in path (like /usr/local/bin) and make it executable (chmod 755). When executed your cursor should change to a crosshair. Mark the area you want to screenshot and the URL to the screenshot will automatically be posted to your clipboard.

The uploaded screenshots will be put in your archive under Screenshots (the same location where MacOS puts them)

Config file

The config file follows the ini format and controls some aspects of how jottad runs. An example config file is listed below. This config file changes the default datadir to /home/roland/.jottaddata, the address jottad listens on to 0.0.0.0, and the log file location to /var/log.

[settings]
; this changes the datadir
Datadir=/home/roland/.jottaddata
; this allows jottad to listen on all interfaces
ListenAddr=0.0.0.0
; this sets a custom logfile location
LogfileDir=/var/log


The config file might not exist, and if it doesn't you need to create it. The possible locations depending on your operating system are listed below. You can use the example file above as a template. Just remember to change or remove the Datadir item.

jottad looks for the config file in the following locations:

linux & freebsd:
/etc/jottad/config.ini

macos:
~/.config/jottad.ini

windows:
installdir\config.ini
(install dir is the same dir as the jottad.exe executable)
Did this answer your question?