E Erlangly

Install

Erlangly runs as one Docker container on a Linux server you choose: a cloud server, a machine in your office, or a virtual machine.

What you need

  • Ubuntu or Debian, on x86-64 or ARM64.
  • 2 GB of memory or more, and a few GB of disk. A small cloud server is enough for most contact centres.
  • For HTTPS: a domain pointed at the server, and ports 80 and 443 open.

Install it

curl -fsSL https://get.erlangly.com | sh

This installs Docker if it isn't there, installs the erlangly command, and starts Erlangly. It then prints a secret setup link: open it to create your organisation and your admin account. Until you do, nobody else can set up your server. Lost it? Run erlangly setup-link.

Check it before you run it

Prefer to read the installer first? Download it, check it against our published checksums, then run it:

curl -fsSLO https://get.erlangly.com/install.sh
curl -fsSL https://get.erlangly.com/SHA256SUMS | sha256sum -c --ignore-missing
sh install.sh

HTTPS

curl -fsSL https://get.erlangly.com | TLS_DOMAIN=wfm.example.com sh

With a domain, Erlangly gets a free Let's Encrypt certificate and serves HTTPS only.

Behind your own proxy

Already running a reverse proxy (nginx, Nginx Proxy Manager, Caddy, a Cloudflare tunnel)? Install Erlangly on another port and tell it the address people open. Your proxy handles HTTPS and forwards to that port; turn WebSockets on for the live wallboard.

curl -fsSL https://get.erlangly.com | ERLANGLY_HTTP_PORT=8095 ERLANGLY_URL=https://wfm.example.com sh

Without a domain or a proxy, Erlangly serves plain HTTP, so passwords and API tokens cross the network unencrypted: use that only on a trusted network.

Other settings

Pass these to the install, or change them later in /etc/erlangly/erlangly.conf and run erlangly restart.

  • ERLANGLY_HTTP_PORT and ERLANGLY_HTTPS_PORT: publish on other ports (80 and 443 by default).
  • ERLANGLY_TAG: install a particular version.
  • ERLANGLY_URL: the address people open, when your own HTTPS proxy is in front.

Docker Compose

Prefer Compose? The compose.yml runs the same container. The erlangly command adds safer upgrades and backups, so we recommend it.