atcli: AlephTransfer CLI User Guide (7)

Aleph Archives

copyright 2010-2021

The following operating systems are supported:

INSTALL

Linux via snap

sudo snap install atcli
sudo /snap/atcli/current/usr/local/bin/post-install.sh ## man page...

Windows via Chocolatey

c:\> choco install atcli

macOS via brew

brew tap alephtransfer/homebrew-atcli
brew install atcli

ALTERNATIVES

Linux:

# DEB package
curl -sLO https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/1.0.6/atcli_1.0.6_amd64.deb && sudo dpkg -i atcli_1.0.6_amd64.deb

# RPM package
sudo rpm -i https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/1.0.6/atcli-1.0.6.x86_64.rpm
sudo yum install https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/1.0.6/atcli-1.0.6.x86_64.rpm

# Ansible
sudo ansible -m apt -a deb=https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/1.0.6/atcli_1.0.6_amd64.deb localhost

# Puppet
package {'atcli':
  provider => dpkg,
  source   => https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/1.0.6/atcli_1.0.6_amd64.deb,
}

Windows MSI installer:

Link: https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/1.0.6/atcli-1.0.6-setup.exe
InstallDir: c:\Program Files (x86)\Aleph Archives\atcli

Auto-installer for macOS, Linux and Windows (Ming + Cygwin):

curl -fsSL https://alephtransfer.com/bin/64eaf935dd53fe3929171149f93c90e0/install.sh | sh

USAGE

On Linux, you can always consult the man page:

man atcli

or check help:

atcli      --help
atcli up   --help        ## upload mode
atcli down --help        ## download mode

EXAMPLES

UPLOAD

You can transfer data files or directories (1-level depth) with:

atcli up --host "https://alephtransfer.mycompany.com/" --path file1 --path file2
atcli up --host "https://alephtransfer.mycompany.com/" --path directory_with_files

The upload mode offers many features among access notification, language selection, retention period, password protection, etc.

Here is how to protect your files with a password, limit download to 3-days, and display the share page in Japanese:

atcli up --host "https://alephtransfer.mycompany.com/" --path file1 --password 12345678 --retention 3 --lang ja

This is the list of supported languages:

en: English
fr: French
es: Spanish
de: German
it: Italian
ja: Japanese
pl: Polish
pt: Portuguese
ru: Russian
zh: Chinese (simplified)
sv: Swedish
hi: Hindi

DOWNLOAD

Downloading files in the current directory is as easy as:

atcli down --link "https://alephtransfer.mycompany.com/#download?q=11cf9d688bc34091b924cea5476dde740100ecbd" --path .

TOKENS

If your AlephTransfer server is restricted (eg. SAML), external members not part of your company can’t transfer files using your endpoint.

In this case, temporary Tokens could be used to allow external members transfer files in safe manner.

atcli up --host "https://alephtransfer.mycompany.com/" --path file1 --token b9f5327b8afb4eb597767043febbcf6b00f4001c

Tokens could be generated from AlephTransfer’s Web interface or service administration script (refer to doc).

PROFILES

When dealing with multiple AlephTransfer endpoints, it might be difficult to remember their respective settings. Profiles came handy and let you organize all your settings in one place.

When you upload files, atcli checks if a default config file exists in the following locations:

$ cat $HOME/.atcli.ini               ## Linux/macOS
c:\> echo %USERPROFILE%/.atcli.ini   ## Windows

A config is a simple ini file:

; this comment is being ignored

;; -----------------
;; default profile
;; -----------------
[main]
host = https://alephtransfer.mycompany.com/
path = /var/log/myapp
password = 1234_5678
from = me@mycompany.com
to = john@gmail.com,john@yahoo.com
subject = Daily backup
msg = Please check log's conformity
retention = 7
lang = en
quiet = true

;; -----------------
;; partner1 profile
;; -----------------
[partner1]
host = https://alephtransfer.partner1.com/
lang = fr
retention = 3

Uploads are much simpler when using profiles:

atcli up                                ## profile main is used
atcli up --profile partner1 --path dir  ## profile partner1 is used

If no profile is specified, main profile is selected.

BUG TRACKER & SUPPORT

All bugs have to be reported here. Please send detailed instructions to let us reproduce the issue (logs, stacktrace, screenshots, os info, etc.).