aaronkelly/aerc repository overview

⁠about

UPDATE: this works well, but I now use nixpkgs.aerc

this is just a dockerised image of aerc. aerc is not my own work

the dockerfiles included build from one of these sources:

• https://git.sr.ht/~sircmpwn/aerc⁠
• https://git.sr.ht/~rjarry/aerc⁠

the sircmpwn repo is the original which is not being actively developed.

the rjarry is an active fork - this is the one currently being used in the docker-compose file.

if your distr has an aerc package (Alpine, Arch or macOS (homebrew)), you may prefer to use that than building a docker image from scratch.

⁠getting started

If you have a aerc folder, copy or create a symlink to it at ~/.config/aerc:

ln -sn ~/.config/aerc ~/src/configfiles/aerc

make sure the file permissions are 0600:

sudo chmod 600 -R ~/.config/aerc

then just run

docker-compose run aerc

here's the equivalent docker run command:

docker run --name aerc --rm -it -v ~/.config/aerc:/root/config/aerc aaronkelly/aerc_docker

if you run the above command with an empty volume mount, the program will prompt you to create a new configuration

my config files at ~/.config/aerc are symlinked to a PRIVATE configfiles repo (https://git.sr.ht/~aaronkelly/configfiles/⁠)

⁠troubleshooting

aerc_1  | goroutine 1 [running]:
aerc_1  | runtime/debug.Stack()
aerc_1  |       /usr/lib/go/src/runtime/debug/stack.go:24 +0x65
aerc_1  | runtime/debug.PrintStack()
aerc_1  |       /usr/lib/go/src/runtime/debug/stack.go:16 +0x19
aerc_1  | main.PanicTermFix(0x0)
aerc_1  |       /app/aerc/aerc.go:212 +0x45
aerc_1  | panic({0x934440, 0xc000168e20})
aerc_1  |       /usr/lib/go/src/runtime/panic.go:1047 +0x266
aerc_1  | main.main()
aerc_1  |       /app/aerc/aerc.go:167 +0xa76
aerc_1  | aerc crashed: exit status 1

did you use docker-compose up? very bad!

use docker-compose run aerc to start the program!

⁠logs

aerc can be started with logs. use this run command to override the entrypoint:

docker run --name aerc -it -v ~/.config/aerc:/root/.config/aerc --entrypoint ash aaronkelly/aerc_docker

then run:

aerc > aerg.logs

spawn a terminal inside aerc and then look at /app/aerc.log

⁠ucdconnect has disabled less secure apps

which means I cannot use aerc to check my ucd email, as connecting with 3rd party apps can only be done via IMAP + OAUTH

⁠contact

If you want to support the maintenance of this image, my contact details are on my blog: https://aaronpkelly.github.io/⁠