2018-08-07 20:51:12 +02:00
|
|
|
|
---
|
|
|
|
|
title: "Jottacloud"
|
|
|
|
|
description: "Rclone docs for Jottacloud"
|
|
|
|
|
---
|
|
|
|
|
|
2020-05-22 13:22:52 +02:00
|
|
|
|
{{< icon "fa fa-cloud" >}} Jottacloud
|
2018-08-07 20:51:12 +02:00
|
|
|
|
-----------------------------------------
|
|
|
|
|
|
2020-05-20 12:39:20 +02:00
|
|
|
|
Jottacloud is a cloud storage service provider from a Norwegian company, using its own datacenters in Norway.
|
2020-05-11 01:00:43 +02:00
|
|
|
|
|
|
|
|
|
In addition to the official service at [jottacloud.com](https://www.jottacloud.com/), there are
|
|
|
|
|
also several whitelabel versions which should work with this backend.
|
|
|
|
|
|
2018-08-07 20:51:12 +02:00
|
|
|
|
Paths are specified as `remote:path`
|
|
|
|
|
|
|
|
|
|
Paths may be as deep as required, eg `remote:directory/subdirectory`.
|
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
## Setup
|
|
|
|
|
|
2020-06-16 17:58:59 +02:00
|
|
|
|
### Default Setup
|
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
To configure Jottacloud you will need to generate a personal security token in the Jottacloud web interface.
|
|
|
|
|
You will the option to do in your [account security settings](https://www.jottacloud.com/web/secure)
|
|
|
|
|
(for whitelabel version you need to find this page in its web interface).
|
|
|
|
|
Note that the web interface may refer to this token as a JottaCli token.
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-06-16 17:58:59 +02:00
|
|
|
|
### Legacy Setup
|
|
|
|
|
|
|
|
|
|
If you are using one of the whitelabel versions (Elgiganten, Com Hem Cloud) you may not have the option
|
|
|
|
|
to generate a CLI token. In this case you'll have to use the legacy authentification. To to this select
|
|
|
|
|
yes when the setup asks for legacy authentification and enter your username and password.
|
|
|
|
|
The rest of the setup is identical to the default setup.
|
|
|
|
|
|
|
|
|
|
Here is an example of how to make a remote called `remote` with the default setup. First run:
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
rclone config
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
|
|
|
|
This will guide you through an interactive setup process:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
No remotes found - make a new one
|
|
|
|
|
n) New remote
|
|
|
|
|
s) Set configuration password
|
|
|
|
|
q) Quit config
|
|
|
|
|
n/s/q> n
|
2020-06-16 17:58:59 +02:00
|
|
|
|
name> remote
|
2018-08-07 20:51:12 +02:00
|
|
|
|
Type of storage to configure.
|
|
|
|
|
Enter a string value. Press Enter for the default ("").
|
|
|
|
|
Choose a number from below, or type in your own value
|
|
|
|
|
[snip]
|
2020-05-20 12:54:33 +02:00
|
|
|
|
XX / Jottacloud
|
2018-08-07 20:51:12 +02:00
|
|
|
|
\ "jottacloud"
|
|
|
|
|
[snip]
|
|
|
|
|
Storage> jottacloud
|
2019-05-17 17:39:11 +02:00
|
|
|
|
** See help for jottacloud backend at: https://rclone.org/jottacloud/ **
|
|
|
|
|
|
2019-04-07 16:12:32 +02:00
|
|
|
|
Edit advanced config? (y/n)
|
|
|
|
|
y) Yes
|
|
|
|
|
n) No
|
|
|
|
|
y/n> n
|
2018-08-07 20:51:12 +02:00
|
|
|
|
Remote config
|
2020-06-16 17:58:59 +02:00
|
|
|
|
Use legacy authentification?.
|
|
|
|
|
This is only required for certain whitelabel versions of Jottacloud and not recommended for normal users.
|
|
|
|
|
y) Yes
|
|
|
|
|
n) No (default)
|
|
|
|
|
y/n> n
|
2019-04-07 16:12:32 +02:00
|
|
|
|
|
2019-11-28 11:03:48 +01:00
|
|
|
|
Generate a personal login token here: https://www.jottacloud.com/web/secure
|
2019-11-20 00:11:19 +01:00
|
|
|
|
Login Token> <your token here>
|
2019-05-17 17:39:11 +02:00
|
|
|
|
|
|
|
|
|
Do you want to use a non standard device/mountpoint e.g. for accessing files uploaded using the official Jottacloud client?
|
|
|
|
|
|
|
|
|
|
y) Yes
|
|
|
|
|
n) No
|
|
|
|
|
y/n> y
|
|
|
|
|
Please select the device to use. Normally this will be Jotta
|
|
|
|
|
Choose a number from below, or type in an existing value
|
|
|
|
|
1 > DESKTOP-3H31129
|
2020-06-16 17:58:59 +02:00
|
|
|
|
2 > Jotta
|
|
|
|
|
Devices> 2
|
2019-05-17 17:39:11 +02:00
|
|
|
|
Please select the mountpoint to user. Normally this will be Archive
|
|
|
|
|
Choose a number from below, or type in an existing value
|
|
|
|
|
1 > Archive
|
2020-05-11 01:00:43 +02:00
|
|
|
|
2 > Links
|
2019-05-17 17:39:11 +02:00
|
|
|
|
3 > Sync
|
2020-05-11 01:00:43 +02:00
|
|
|
|
|
2019-05-17 17:39:11 +02:00
|
|
|
|
Mountpoints> 1
|
2018-08-07 20:51:12 +02:00
|
|
|
|
--------------------
|
2019-05-17 17:39:11 +02:00
|
|
|
|
[jotta]
|
2018-08-07 20:51:12 +02:00
|
|
|
|
type = jottacloud
|
2019-04-07 16:12:32 +02:00
|
|
|
|
token = {........}
|
2019-05-17 17:39:11 +02:00
|
|
|
|
device = Jotta
|
|
|
|
|
mountpoint = Archive
|
2019-11-20 00:11:19 +01:00
|
|
|
|
configVersion = 1
|
2018-08-07 20:51:12 +02:00
|
|
|
|
--------------------
|
|
|
|
|
y) Yes this is OK
|
|
|
|
|
e) Edit this remote
|
|
|
|
|
d) Delete this remote
|
|
|
|
|
y/e/d> y
|
|
|
|
|
```
|
|
|
|
|
Once configured you can then use `rclone` like this,
|
|
|
|
|
|
|
|
|
|
List directories in top level of your Jottacloud
|
|
|
|
|
|
|
|
|
|
rclone lsd remote:
|
|
|
|
|
|
|
|
|
|
List all the files in your Jottacloud
|
|
|
|
|
|
|
|
|
|
rclone ls remote:
|
|
|
|
|
|
|
|
|
|
To copy a local directory to an Jottacloud directory called backup
|
|
|
|
|
|
|
|
|
|
rclone copy /home/source remote:backup
|
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Devices and Mountpoints
|
2019-05-17 17:39:11 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
The official Jottacloud client registers a device for each computer you install it on,
|
|
|
|
|
and then creates a mountpoint for each folder you select for Backup.
|
|
|
|
|
The web interface uses a special device called Jotta for the Archive and Sync mountpoints.
|
|
|
|
|
In most cases you'll want to use the Jotta/Archive device/mountpoint, however if you want to access
|
|
|
|
|
files uploaded by any of the official clients rclone provides the option to select other devices
|
|
|
|
|
and mountpoints during config.
|
2019-05-17 17:39:11 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
The built-in Jotta device may also contain several other mountpoints, such as: Latest, Links, Shared and Trash.
|
|
|
|
|
These are special mountpoints with a different internal representation than the "regular" mountpoints.
|
|
|
|
|
Rclone will only to a very limited degree support them. Generally you should avoid these, unless you know what you
|
|
|
|
|
are doing.
|
|
|
|
|
|
|
|
|
|
### --fast-list
|
2018-09-06 15:13:38 +02:00
|
|
|
|
|
|
|
|
|
This remote supports `--fast-list` which allows you to use fewer
|
|
|
|
|
transactions in exchange for more memory. See the [rclone
|
|
|
|
|
docs](/docs/#fast-list) for more details.
|
|
|
|
|
|
|
|
|
|
Note that the implementation in Jottacloud always uses only a single
|
|
|
|
|
API request to get the entire list, so for large folders this could
|
|
|
|
|
lead to long wait time before the first results are shown.
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Modified time and hashes
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
|
|
|
|
Jottacloud allows modification times to be set on objects accurate to 1
|
2020-05-11 01:00:43 +02:00
|
|
|
|
second. These will be used to detect whether objects need syncing or
|
2018-08-07 20:51:12 +02:00
|
|
|
|
not.
|
|
|
|
|
|
|
|
|
|
Jottacloud supports MD5 type hashes, so you can use the `--checksum`
|
|
|
|
|
flag.
|
|
|
|
|
|
2018-08-20 16:38:21 +02:00
|
|
|
|
Note that Jottacloud requires the MD5 hash before upload so if the
|
|
|
|
|
source does not have an MD5 checksum then the file will be cached
|
|
|
|
|
temporarily on disk (wherever the `TMPDIR` environment variable points
|
2020-09-03 11:31:11 +02:00
|
|
|
|
to) before it is uploaded. Small files will be cached in memory - see
|
2020-05-11 01:00:43 +02:00
|
|
|
|
the [--jottacloud-md5-memory-limit](#jottacloud-md5-memory-limit) flag.
|
2020-09-03 11:31:11 +02:00
|
|
|
|
When uploading from local disk the source checksum is always available,
|
|
|
|
|
so this does not apply. Starting with rclone version 1.52 the same is
|
|
|
|
|
true for crypted remotes (in older versions the crypt backend would not
|
|
|
|
|
calculate hashes for uploads from local disk, so the Jottacloud
|
|
|
|
|
backend had to do it as described above).
|
2018-08-20 16:38:21 +02:00
|
|
|
|
|
2018-11-02 13:13:47 +01:00
|
|
|
|
#### Restricted filename characters
|
|
|
|
|
|
|
|
|
|
In addition to the [default restricted characters set](/overview/#restricted-characters)
|
|
|
|
|
the following characters are also replaced:
|
|
|
|
|
|
|
|
|
|
| Character | Value | Replacement |
|
|
|
|
|
| --------- |:-----:|:-----------:|
|
|
|
|
|
| " | 0x22 | " |
|
|
|
|
|
| * | 0x2A | * |
|
|
|
|
|
| : | 0x3A | : |
|
|
|
|
|
| < | 0x3C | < |
|
|
|
|
|
| > | 0x3E | > |
|
|
|
|
|
| ? | 0x3F | ? |
|
|
|
|
|
| \| | 0x7C | | |
|
|
|
|
|
|
|
|
|
|
Invalid UTF-8 bytes will also be [replaced](/overview/#invalid-utf8),
|
|
|
|
|
as they can't be used in XML strings.
|
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Deleting files
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
By default rclone will send all files to the trash when deleting files. They will be permanently
|
2020-05-19 13:02:44 +02:00
|
|
|
|
deleted automatically after 30 days. You may bypass the trash and permanently delete files immediately
|
2020-05-11 01:00:43 +02:00
|
|
|
|
by using the [--jottacloud-hard-delete](#jottacloud-hard-delete) flag, or set the equivalent environment variable.
|
|
|
|
|
Emptying the trash is supported by the [cleanup](/commands/rclone_cleanup/) command.
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Versions
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
Jottacloud supports file versioning. When rclone uploads a new version of a file it creates a new version of it.
|
|
|
|
|
Currently rclone only supports retrieving the current version but older versions can be accessed via the Jottacloud Website.
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Quota information
|
2018-09-06 19:55:16 +02:00
|
|
|
|
|
|
|
|
|
To view your current quota you can use the `rclone about remote:`
|
|
|
|
|
command which will display your usage limit (unless it is unlimited)
|
|
|
|
|
and the current usage.
|
|
|
|
|
|
2020-05-22 13:22:52 +02:00
|
|
|
|
{{< rem autogenerated options start" - DO NOT EDIT - instead edit fs.RegInfo in backend/jottacloud/jottacloud.go then run make backenddocs" >}}
|
2018-10-01 21:48:54 +02:00
|
|
|
|
### Advanced Options
|
|
|
|
|
|
2020-05-20 12:54:33 +02:00
|
|
|
|
Here are the advanced options specific to jottacloud (Jottacloud).
|
2018-10-01 21:48:54 +02:00
|
|
|
|
|
|
|
|
|
#### --jottacloud-md5-memory-limit
|
|
|
|
|
|
|
|
|
|
Files bigger than this will be cached on disk to calculate the MD5 if required.
|
|
|
|
|
|
|
|
|
|
- Config: md5_memory_limit
|
|
|
|
|
- Env Var: RCLONE_JOTTACLOUD_MD5_MEMORY_LIMIT
|
|
|
|
|
- Type: SizeSuffix
|
|
|
|
|
- Default: 10M
|
|
|
|
|
|
2020-04-11 12:11:20 +02:00
|
|
|
|
#### --jottacloud-trashed-only
|
|
|
|
|
|
|
|
|
|
Only show files that are in the trash.
|
|
|
|
|
This will show trashed files in their original directory structure.
|
|
|
|
|
|
|
|
|
|
- Config: trashed_only
|
|
|
|
|
- Env Var: RCLONE_JOTTACLOUD_TRASHED_ONLY
|
|
|
|
|
- Type: bool
|
|
|
|
|
- Default: false
|
|
|
|
|
|
2018-10-01 21:48:54 +02:00
|
|
|
|
#### --jottacloud-hard-delete
|
|
|
|
|
|
|
|
|
|
Delete files permanently rather than putting them into the trash.
|
|
|
|
|
|
|
|
|
|
- Config: hard_delete
|
|
|
|
|
- Env Var: RCLONE_JOTTACLOUD_HARD_DELETE
|
|
|
|
|
- Type: bool
|
|
|
|
|
- Default: false
|
|
|
|
|
|
2019-02-09 11:42:57 +01:00
|
|
|
|
#### --jottacloud-upload-resume-limit
|
|
|
|
|
|
|
|
|
|
Files bigger than this can be resumed if the upload fail's.
|
|
|
|
|
|
|
|
|
|
- Config: upload_resume_limit
|
|
|
|
|
- Env Var: RCLONE_JOTTACLOUD_UPLOAD_RESUME_LIMIT
|
|
|
|
|
- Type: SizeSuffix
|
|
|
|
|
- Default: 10M
|
|
|
|
|
|
2020-02-01 11:31:42 +01:00
|
|
|
|
#### --jottacloud-encoding
|
|
|
|
|
|
|
|
|
|
This sets the encoding for the backend.
|
|
|
|
|
|
|
|
|
|
See: the [encoding section in the overview](/overview/#encoding) for more info.
|
|
|
|
|
|
|
|
|
|
- Config: encoding
|
|
|
|
|
- Env Var: RCLONE_JOTTACLOUD_ENCODING
|
|
|
|
|
- Type: MultiEncoder
|
|
|
|
|
- Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Del,Ctl,InvalidUtf8,Dot
|
|
|
|
|
|
2020-05-22 13:22:52 +02:00
|
|
|
|
{{< rem autogenerated options stop >}}
|
2018-10-01 19:36:15 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Limitations
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
|
|
|
|
Note that Jottacloud is case insensitive so you can't have a file called
|
|
|
|
|
"Hello.doc" and one called "hello.doc".
|
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
There are quite a few characters that can't be in Jottacloud file names. Rclone will map these names to and from an identical
|
|
|
|
|
looking unicode equivalent. For example if a file has a ? in it will be mapped to ? instead.
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
|
|
|
|
Jottacloud only supports filenames up to 255 characters in length.
|
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
### Troubleshooting
|
2018-08-07 20:51:12 +02:00
|
|
|
|
|
2020-05-11 01:00:43 +02:00
|
|
|
|
Jottacloud exhibits some inconsistent behaviours regarding deleted files and folders which may cause Copy, Move and DirMove
|
|
|
|
|
operations to previously deleted paths to fail. Emptying the trash should help in such cases.
|