Livebook Interactive Elixir Notebook - Support

This is a repackaged open source software product wherein additional charges apply for cloudimg support services.

## Interactive Elixir Notebooks, Ready to Run

Livebook is the open source interactive and collaborative notebook for Elixir. Code cells, Markdown prose, live inputs, data tables and charts live together in one reproducible plain text `.livemd` document. This image delivers Livebook fully installed on a complete BEAM toolchain, behind an HTTPS reverse proxy, with a unique access password generated on every first boot.

## Who This Is For

Elixir and Erlang engineering teams exploring data, prototyping modules, and documenting behaviour in runnable notebooks that live in version control alongside the code. Data and platform teams building shareable, reproducible analyses and internal dashboards without standing up a Python stack. Educators and consultancies delivering interactive Elixir training material that a student can run unchanged.

## Application Stack

• Livebook 0.19 notebook server, run as a dedicated unprivileged system user
• Erlang/OTP 28 compiled from the official pinned source tarball with checksum verification
• Elixir 1.20 from the official pinned release, on the default PATH
• nginx terminating TLS on port 443 and reverse proxying with WebSocket upgrade so LiveView and collaborative editing work
• The notebook server binds the loopback interface only and is never directly network exposed

## Secure By Default

Livebook evaluates arbitrary Elixir, so an unprotected instance is remote code execution. This image never ships an open or default credential:

• A one-shot first boot service generates a unique 28 character access password and a unique Erlang distribution cookie on every instance
• Credentials are written to a root-only file, never baked into the image
• Unauthenticated requests are redirected to the sign-in page; only an authenticated session reaches a notebook
• A per-instance self-signed TLS certificate is generated at first boot with the instance address in its subject alternative names
• An unauthenticated health endpoint is exposed separately for load balancer probes

## Storage

Notebooks and Livebook internal state live on a dedicated 20 GiB EBS volume mounted at `/var/lib/livebook`, referenced in fstab by filesystem UUID and independently resizable from the operating system disk. A sample welcome notebook demonstrating an Elixir code cell, Markdown and a chart ships on that volume.

## Getting Started

1. Launch the AMI on an m5.large instance or larger, opening ports 443 and 22 in your security group

2. SSH into the instance and read the generated password from the root-only credentials file

3. Browse to `https:///` and accept the per-instance self-signed certificate

4. Sign in with the generated password

5. Open the sample notebook, or create your own and evaluate an Elixir cell

6. Point a real domain and a CA signed certificate at nginx when you are ready to share the instance

## Recommended Instance Sizing

• Minimum: t3.medium (2 vCPU, 4 GB RAM) for a single user evaluating notebooks
• Recommended: m5.large (2 vCPU, 8 GB RAM) for regular interactive use
• Larger workloads: notebook runtimes spawn a fresh BEAM node per session, so scale vCPU and memory with concurrent notebooks and dataset size
• Storage: the 20 GiB notebook volume can be grown in place as your notebook library grows

## Use Case: Reproducible Analysis in Elixir

A platform team investigating a production incident opens a notebook, connects to their own data source in an Elixir cell, and charts the result inline. The notebook is a plain `.livemd` file, so it is committed next to the service it describes and re-run unchanged by the next engineer on call. Nothing about the analysis lives only in someone's terminal history.

## 24/7 cloudimg Support

Every deployment is backed by cloudimg engineers available around the clock by email and live chat. Support covers:

• Deployment and instance sizing guidance
• TLS termination with your own certificate or a public CA
• Access password rotation and hardening the instance behind your own network controls
• Notebook volume growth, backup and recovery
• Erlang/OTP and Elixir runtime questions relating to this image
• Livebook upgrades and troubleshooting

Critical issues receive a one-hour average response time.

## Ready to Evaluate?

This AMI uses standard AWS pay-as-you-go infrastructure billing. Launch an instance to explore the full notebook experience, and terminate at any time with no long-term commitment. For pre-purchase questions, contact support@cloudimg.co.uk before you subscribe.

Livebook, Elixir and Erlang are trademarks of their respective owners. All product and company names are trademarks or registered trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.