Overview
Reading an article in yarr
The yarr three-pane reader with an article open in the reading pane: folders and feeds in the sidebar, the article list in the middle, and the selected article rendered clean on the right.
Reading an article in yarr
Folders, feeds and unread articles
Add feeds, themes and OPML import/export
This is a repackaged open source software product wherein additional charges apply for cloudimg support services.
Overview
yarr (yet another rss reader) is a fast, lightweight, self-hosted RSS and Atom feed reader and aggregator built as a single Go binary with an embedded web interface and SQLite database. It starts in seconds, requires no external database, and keeps your reading history entirely on infrastructure you control. Subscribe to any website's feed, organise subscriptions into folders, and read articles in a clean, distraction-free reading view with unread tracking, full-text search, a built-in readability mode, and OPML import and export. A system-based light and dark theme follows your browser preference.
This AMI delivers yarr fully installed and reverse-proxied behind nginx, so a working, authenticated feed reader is running within minutes of launch with no manual package installation, no dependency troubleshooting, and no proxy configuration required.
Why This AMI vs Other Options
Compared to a manual install: The image completes every build and hardening step at creation time - fetching the binary, authoring a systemd unit, configuring a reverse proxy, and adding authentication that yarr does not provide natively. You skip all of it.
Compared to database-backed self-hosted readers: yarr has no external database dependency. A single Go binary plus embedded SQLite means fewer moving parts, a smaller attack surface, and lower resource consumption, so it runs comfortably on small instances.
Compared to SaaS feed services: Your subscriptions, reading history, and article content stay entirely within your AWS account. No data leaves your VPC unless you choose to expose the instance.
Security Hardening
- Network isolation: yarr binds exclusively to the loopback interface; only the nginx reverse proxy is exposed, so authentication cannot be bypassed by reaching the app directly
- Authentication enforced: every request is authenticated at nginx, with an unauthenticated health endpoint provided only for loopback probes
- No default or shared credentials: a cryptographically random admin password is generated on each instance's first boot and written only to a root-only file
- Least privilege: the reader runs as an unprivileged system user with NoNewPrivileges, PrivateTmp, and ProtectSystem set; systemd restarts it on failure
Populated Out of the Box
The reader arrives pre-populated with self-contained demo feeds served from the image itself, so the interface shows folders, feeds, and articles the moment you sign in. You can evaluate the UI immediately before adding your own subscriptions.
Concrete Use Cases
- Aggregating vulnerability and vendor feeds: A security or operations team subscribes to many disclosure and vendor feeds, organises them by source and severity, and uses full-text search to surface relevant advisories across all sources without sending data to a third-party platform.
- OPML migration target: Import an existing subscription list exported from another reader and continue reading immediately, with folders and unread state preserved.
- Backend for mobile reading apps: Point a Fever-compatible mobile client at the instance so phones and tablets sync against a private, self-owned feed store.
Features
Feed subscription with automatic discovery, folder organisation, per-feed and per-folder unread views, full-text search across articles, readability view for clean article extraction, OPML import and export, a Fever-compatible API for third-party mobile apps, and a responsive interface that works on phones as a progressive web app.
AWS Integration
Deploy on any EC2 instance type. Place the reader in a VPC subnet with security-group control over inbound access, terminate TLS with your own domain and certificate at the nginx layer, and snapshot or resize the dedicated data volume independently of the OS disk using EBS or AWS Backup.
Getting Started
- Launch the AMI on your chosen instance type.
- SSH in and read the generated admin credential from the root-only file indicated in the login banner.
- Open the web interface in your browser and sign in.
- Browse the pre-loaded demo feeds to explore the UI.
- Add your own feeds with the plus button in the sidebar, organise them into folders, or import an OPML file to bring existing subscriptions across.
For a guided deployment walkthrough or help with TLS termination and mobile app configuration, contact cloudimg support at any time.
cloudimg Support
24/7 technical support by email and chat. Help with deployment, TLS termination, credential management, OPML import and export, and connecting Fever-compatible mobile apps.
This is a repackaged open source software product with additional charges for cloudimg support services. yarr is distributed under the MIT license.
Highlights
- Launch-and-use with zero configuration: the AMI completes every build and hardening step at image creation time - binary installation, systemd service, nginx reverse proxy, and authentication layer. Launch an instance and reach a working, login-protected feed reader without editing a single file, and it runs comfortably on small, low-cost instances.
- Unique-per-instance security with no default password: yarr has no built-in authentication, so this image binds it exclusively to the loopback interface and fronts it with nginx enforcing an HTTP login on every request. Each instance generates its own cryptographically random admin credential on first boot - no two deployments share a password and the reader is never reachable unauthenticated. The credential is stored in a root-only file, never baked into the image.
- Single-binary architecture with dedicated storage and 24/7 support: a Go binary with embedded SQLite on a dedicated, independently resizable EBS data volume means no external database to manage and simple backup via EBS snapshots or AWS Backup. Arrives pre-populated with demo feeds so you see folders and articles immediately. A Fever-compatible API supports mobile apps. Backed by 24/7 cloudimg technical support via email and chat.
Details
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Pricing
Free trial
- ...
Dimension | Description | Cost/hour |
|---|---|---|
m5.large Recommended | m5.large | $0.08 |
t2.micro | t2.micro instance type | $0.04 |
t3.micro | t3.micro instance type | $0.04 |
c5a.12xlarge | c5a.12xlarge instance type | $0.24 |
c5a.16xlarge | c5a.16xlarge instance type | $0.24 |
c5a.24xlarge | c5a.24xlarge instance type | $0.24 |
c5a.2xlarge | c5a.2xlarge instance type | $0.24 |
c5a.4xlarge | c5a.4xlarge instance type | $0.24 |
c5a.8xlarge | c5a.8xlarge instance type | $0.24 |
c5a.large | c5a.large instance type | $0.08 |
Vendor refund policy
Refunds available on request.
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
64-bit (x86) Amazon Machine Image (AMI)
Amazon Machine Image (AMI)
An AMI is a virtual image that provides the information required to launch an instance. Amazon EC2 (Elastic Compute Cloud) instances are virtual servers on which you can run your applications and workloads, offering varying combinations of CPU, memory, storage, and networking resources. You can launch as many instances from as many different AMIs as you need.
Version release notes
Initial release of yarr as a ready-to-use self-hosted RSS and Atom feed reader appliance, running behind an nginx reverse proxy that enforces an HTTP login with a unique admin password generated on each instance's first boot, with the SQLite feed database on a dedicated data volume and self-contained demo feeds that populate the reader on first sign-in.
Additional details
Usage instructions
Connect via SSH on port 22 as the default login user for your operating system variant (for the Ubuntu 24.04 variant the user is ubuntu). Read the per-instance web credential with: sudo cat /root/yarr-info.txt. Open the web interface in a browser at http://<instance-public-ip>/ and sign in with the username (admin) and password from that file. The reader arrives pre-populated with self-contained demo feeds. Add your own feeds with the plus button in the sidebar, organise them into folders, search articles and import an OPML subscription list. The reader binds to the loopback interface and is served through nginx on port 80, ready for you to terminate TLS with your own domain and certificate. The feed database lives on a dedicated data volume mounted at /var/lib/yarr. The instance security group opens ports 22 and 80. The services run under systemd: systemctl status yarr nginx.
Resources
Vendor resources
Support
Vendor support
cloudimg Support
cloudimg provides 24/7 technical support for this product by email and live chat.
Contact: support@cloudimg.co.uk
What we help with:
- Deployment and initial configuration on any EC2 instance type
- TLS termination with your own domain and certificate
- Changing the login credential and managing access
- OPML import and export
- Connecting Fever-compatible mobile apps
- Updates and security patching guidance
- EBS volume resizing and backup configuration
- Troubleshooting nginx proxy and systemd service issues
How to get help:
Email support@cloudimg.co.uk or use the live chat channel. Include your instance ID and a brief description of the issue for fastest resolution.
Refunds: For refund requests, contact support@cloudimg.co.uk with your AWS account ID and subscription details.
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.