Overview
Fauxton sign-in page
The CouchDB Fauxton admin interface sign-in page, served on first boot with no manual setup.
Fauxton sign-in page
All databases overview
Document view
This is a repackaged open source software product wherein additional charges apply for cloudimg support services.
Overview
Apache CouchDB is an open source, document-oriented NoSQL database that stores data as JSON documents, exposes every operation over a RESTful HTTP API, and ships with the Fauxton browser-based admin interface. This AMI delivers CouchDB fully installed and configured so you have a production-ready document database running within minutes of launch - no manual installation, no separate runtime dependencies, and no insecure defaults. The current release available is CouchDB 3.
Why This AMI Over a Manual Install
Unlike bare CouchDB packages or competing AMIs that ship in insecure "admin party" mode with shared default credentials, this image generates a unique administrator password on every first boot. You skip the multi-step installation of Erlang, CouchDB, and configuration hardening entirely. There is no Java dependency and no separate runtime to manage - the Erlang virtual machine is bundled inside the CouchDB package.
Database Stack
Apache CouchDB runs as a systemd service in single-node mode. The HTTP REST API, the Fauxton admin interface, and the replication protocol all listen on a single port (5984), simplifying firewall rules and load balancer configuration. Database files are stored on a dedicated, independently resizable EBS data disk so you can scale storage without touching the root volume.
AWS Integration Points
- Amazon CloudWatch - Configure CouchDB log forwarding to CloudWatch Logs for centralized monitoring and alerting on database events.
- Amazon S3 - Schedule automated backups of your CouchDB data directory to S3 for durable, cost-effective disaster recovery.
- Application Load Balancer - Place an ALB in front of CouchDB instances to distribute HTTP API traffic and terminate TLS.
- PouchDB - CouchDB's native replication protocol integrates directly with PouchDB for offline-first mobile and web applications that sync data when connectivity returns.
Secure First Boot
On the first boot of your instance, a one-shot systemd service generates a fresh CouchDB administrator password unique to that instance, writes it into the CouchDB configuration, and stores the plain-text value in a root-only file at /opt/couchdb/etc/local.d/admin_password. No shared or default credentials ship in the image. Without this mechanism, CouchDB would run in insecure admin party mode where any user has full administrative access.
Getting Started
- Launch the AMI in your VPC with a security group allowing inbound TCP on port 5984.
- SSH into the instance and read the generated admin password: sudo cat /opt/couchdb/etc/local.d/admin_password
- Browse to http://your-instance-ip:5984/_utils to open the Fauxton admin interface.
- Log in with username "admin" and the retrieved password.
- Create your first database and begin storing JSON documents immediately.
Recommended instance types: t3.medium for development and testing, m5.large or larger for production workloads with sustained throughput.
Use Cases
- Field service mobile sync - A fleet of tablets running PouchDB collects inspection data offline and syncs automatically to CouchDB when connectivity returns, ensuring zero data loss for distributed field teams.
- Document and content stores - Store, version, and retrieve JSON documents with built-in conflict resolution.
- Catalogue and configuration data - Serve product catalogues or application configuration via the HTTP API.
- Event and audit logging - Append-only document writes with document-level ACID semantics.
- Multi-master replication across AWS regions - CouchDB's native replication protocol enables active-active deployments across multiple regions for high availability.
cloudimg Support
24/7 technical support by email and live chat. Our engineers provide expert assistance with CouchDB deployment architecture, upgrades, replication topology design, performance tuning, and database administration. Critical issues receive a one-hour average response time.
To discuss your deployment requirements or request a guided walkthrough of CouchDB replication setup, contact our team at support@cloudimg.co.uk .
Evaluation
We encourage you to launch an instance and explore the Fauxton interface and REST API to evaluate fit for your workload before committing to production use.
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.
Highlights
- Production-ready in minutes with zero manual setup - CouchDB 3, the Fauxton web admin interface, and the full HTTP REST API all run on a single port (5984). Unlike manual installations requiring separate Erlang setup and multi-step configuration, this AMI launches a complete document database with no runtime dependencies and no Java. Database files reside on a dedicated EBS data disk you can resize independently without downtime.
- Secure by default where alternatives are not - every instance generates a unique administrator password on first boot and stores it in a root-only file. Competing CouchDB images often ship in insecure admin party mode with shared default credentials, exposing your data to unauthorized access. This AMI eliminates that risk automatically so your database is hardened from the moment it starts accepting connections.
- 24/7 expert support from cloudimg with one-hour average response for critical issues. Our engineers assist with CouchDB deployment architecture, replication topology across AWS regions, performance tuning, upgrades, and integration with AWS services like Amazon CloudWatch and Amazon S3. You get dedicated database expertise rather than generic community forums.
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 |
t3.micro | t3.micro instance type | $0.04 |
t2.micro | t2.micro instance type | $0.04 |
m6id.large | m6id.large instance type | $0.08 |
i7ie.2xlarge | i7ie.2xlarge instance type | $0.24 |
c8i.metal-96xl | c8i.metal-96xl instance type | $0.24 |
x2iezn.2xlarge | x2iezn.2xlarge instance type | $0.24 |
m6a.metal | m6a.metal instance type | $0.24 |
m6id.8xlarge | m6id.8xlarge instance type | $0.24 |
r8a.metal-48xl | r8a.metal-48xl instance type | $0.24 |
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 Apache CouchDB 3 document database.
Additional details
Usage instructions
Connect via SSH on port 22 as the default login user for your operating system variant (the user guide lists it per variant). CouchDB serves the HTTP API and the Fauxton admin interface on port 5984. Browse to http://<instance-public-ip>:5984/_utils/ and sign in as the 'admin' user. Retrieve the generated administrator password with: sudo cat /root/couchdb-credentials.txt. Restrict port 5984 to trusted networks because the Fauxton admin interface shares that port. To enable HTTPS, follow the reverse proxy section of the user guide.
Resources
Vendor resources
Support
Vendor support
cloudimg Support
cloudimg provides 24/7 technical support for this Apache CouchDB AMI by email and live chat.
How to Get Help
- Email: support@cloudimg.co.uk
- Live chat: Available 24/7 through our support portal
What We Cover
- CouchDB deployment and initial configuration
- Replication topology design and troubleshooting
- Performance tuning and query optimization
- Upgrades and patch guidance
- Security hardening and access control
- Integration with AWS services (CloudWatch, S3, ALB)
- General database administration
Response Times
Critical issues receive a one-hour average response time. Our engineers work to resolve all inquiries as quickly as possible regardless of severity.
Getting Started After Launch
- Launch the AMI with a security group allowing inbound TCP on port 5984.
- SSH into your instance and retrieve the auto-generated admin password from the root-only file.
- Browse to http://your-instance-ip:5984/_utils to access the Fauxton admin interface.
- Log in with username "admin" and the retrieved password.
Recommended instance types: t3.medium for development, m5.large or larger for production workloads.
For deployment consultations, replication architecture reviews, or refund requests, contact support@cloudimg.co.uk and our team will respond promptly.
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.
Similar products
