aboutsummaryrefslogtreecommitdiff
path: root/docs/cli.md
blob: 4ca2bbf3a2f5c35d2caa0d7ab1a3a3406e184cdd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# SYNOPSIS

    alps [options...] <upstream servers...>

# DESCRIPTION

alps is a simple and extensible webmail. It offers a web interface for IMAP,
SMTP and other upstream servers.

At least one upstream IMAP server needs to be specified. The easiest way to do
so is to just specify a domain name:

    alps example.org

This assumes SRV DNS records are properly set up (see [RFC 6186]).

Alternatively, one or more upstream server URLs can be specified:

    alps imaps://mail.example.org:993 smtps://mail.example.org:465

The following URL schemes are supported:

* `imaps` (IMAP with TLS), `imap+insecure` (plain IMAP)
* `smtps` (SMTP with TLS), `smtp+insecure` (plain SMTP)
* `https` (CardDAV and CalDAV over HTTPS), `http+insecure` (CardDAV and CalDAV
  over plain HTTP)
* `carddavs` (CardDAV over HTTPS), `carddav+insecure` (CardDAV over plain HTTP)
* `caldavs` (CalDAV over HTTPS), `caldav+insecure` (CalDAV over plain HTTP)

# OPTIONS

**-theme**: default theme (default: no theme)

**-addr**: listening address (default: ":1323")

**-debug**: enable debug logs and print IMAP network activity

**-login-key**: supply a secret key to preserve logins over application restart.

**-h**, **--help**: show help message and exit

# SIGNALS

**SIGUSR1**: reloads templates and Lua plugins

# LOGIN-KEY

A login key can be used to preserve user sessions over application restarts if
the user has selected 'remember me' on the login page. A key can be generated 
by running `go run github.com/fernet/fernet-go/cmd/fernet-keygen`

[RFC 6186]: https://tools.ietf.org/html/rfc6186