Overview
This AMI runs Grist, the open-source relational spreadsheet, on Ubuntu 24.04 LTS: tables linked like a database, Python formulas, access rules, a REST API and document import and export. The upstream vendor image, release 1.7.22, is pinned and baked into the AMI, so first start does not depend on a registry. It is the vendor's all-open-source image, which contains no code from the vendor's paid full edition.
What Perimattic adds
Administrator created for you: the one administrator account is created during first-login setup, before the site is published, with a random password generated on your server. Apache provides HTTPS with a free Let's Encrypt certificate for your domain.
Limits you should know
There is no sign-up and no public or anonymous access, so documents cannot be shared with people who are not signed in. More people are added by creating another login whose user name is that person's email address (a one-line command on the server). Because Apache uses the Authorization header for the login, Grist's own API keys cannot be used; scripts use the same login. Grist trusts the user name Apache gives it, so do not publish port 8484 or remove the Apache site. Grist prints the installation boot key to its own container log at startup, which only root and the docker group can read. No email server is configured. Documents are SQLite files in /opt/app/persist on the root volume, so choose the root EBS volume size for your data and take EBS snapshots for backup.
Grist used about 420 to 450 MB of memory when empty and the whole host about 0.8 to 0.9 GB; a t3.small (2 GB) passed all tests. A t3.medium (4 GB) is the recommended starting size for real use.
Licence and attribution
Grist is released under the Apache License 2.0; the image used here contains only that open-source code. Built on the open-source Grist (Apache-2.0). Not affiliated with, endorsed by, or sponsored by Grist Labs; Grist is a trademark of its owner.
Getting Started Launch the AMI and open ports 22, 80 and 443 in the security group SSH in and answer the setup prompts (domain and admin email) Open https://your-domain and sign in with your email address and the password printed at the end of setup Create your first document
A domain name with an A record pointing at the instance is required, because the site is served over HTTPS.
This AMI is built and supported by Perimattic.
Book a free setup consultation at https://cal.com/gaurav-pareek-perimattic/marketplace-setup-consultations or email us at aws-support@perimattic.com .
Support Managed and supported by Perimattic, a cloud infrastructure company with 13+ years of experience serving global clients. We offer free setup assistance, custom integrations, infrastructure consulting, and 24/7 support.
Highlights
- Grist 1.7.22 (Apache-2.0, all-open-source image), pinned and pre-installed: a relational spreadsheet with Python formulas, access rules and a REST API on your own server.
- Secure first login: Apache requires a login with your email and a random 24-character password before any request reaches Grist; no anonymous access; formulas run in a gVisor sandbox; telemetry off; HTTPS through Apache and Let's Encrypt.
- Built on patched Ubuntu 24.04 LTS and supported by Perimattic: free setup assistance at aws-support@perimattic.com.
Details
Features and programs
Financing for AWS Marketplace purchases
Pricing
- ...
Dimension | Cost/hour |
|---|---|
t3.medium Recommended | $0.03 |
t3.micro | $0.03 |
c3.2xlarge | $0.03 |
c3.4xlarge | $0.03 |
c3.8xlarge | $0.03 |
c3.large | $0.03 |
c3.xlarge | $0.03 |
c4.2xlarge | $0.03 |
c4.4xlarge | $0.03 |
c4.8xlarge | $0.03 |
Vendor refund policy
For any questions or concerns, please contact: Perimattic.com Email: aws-support@perimattic.com
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.
- Application: Grist 1.7.22 (container image pinned, baked into the AMI).
- Base: Ubuntu 24.04 LTS, fully patched at build time, built by an automated EC2 Image Builder pipeline.
- TLS: Apache reverse proxy with a Let's Encrypt certificate requested by certbot at first login.
- Credentials are generated on the instance at first login; none are present in the image.
- Grist has no accounts here: one login (your admin email, a random 24-character password stored as a bcrypt hash) is enforced by Apache before every request and its user name is passed to Grist; setup skips the first-run Quick setup and the tests verify that anonymous, wrong-password, forged-header and unauthenticated websocket requests are refused.
- Application: Grist 1.7.22 (Apache-2.0), the vendor's all-open-source image, unmodified and pinned. Formulas run in a gVisor sandbox; telemetry and the automatic version check are off.
- No public sharing, no sign-up, no Grist API keys (Apache uses the Authorization header); no email server.
Additional details
Usage instructions
-
Launch an Instance
From AWS Marketplace, click Continue to Subscribe and then Continue to Configuration to launch the AMI.
-
Choose the Recommended Instance Type
t3.medium (4 GB of memory) is the recommended starting size. Grist used about 420 to 450 MB when empty and the whole host about 0.8 to 0.9 GB; a t3.small (2 GB) passed all tests. Size up with your documents and users.
-
Configure Security Group
Allow inbound traffic on the following ports:
- 22 (SSH) - terminal access for setup
- 80 (HTTP) - needed to validate your domain for the TLS certificate
- 443 (HTTPS) - access to Grist
-
Point a domain at the instance
Create a DNS A record (for example grist.example.com) pointing to the instance's public IP before you log in.
-
Connect to the Instance
ssh -i <your-key.pem> ubuntu@<public-ip>
-
First-Login Setup
The first SSH login runs a guided setup:
- Prompts for your domain and admin email and checks the DNS A record
- Generates a random 24-character password, a session secret and an admin boot key on your server and stores the login as a bcrypt hash for Apache
- Starts Grist on the loopback interface with sign-in delegated to Apache, the first-run setup page skipped and telemetry off
- Configures Apache as an HTTPS reverse proxy that requires the login for every request, and requests a Let's Encrypt certificate
- Prints the URL, the login and the boot key; they are also stored in /opt/app/access.txt (root only)
If a step fails, fix the problem shown and log in again: the setup resumes where it stopped.
-
Access Grist
Open https://<your-domain> and sign in with your email address and the generated password (view it again with: sudo cat /opt/app/access.txt). The installation admin panel is at https://<your-domain>/admin and asks for the boot key from the same file.
-
Credentials
Generated on your server, never shared between customers. View them again with:
sudo cat /opt/app/access.txt
-
Manage the Services
cd /opt/app sudo docker compose ps sudo docker compose restart
Documents are in /opt/app/persist (owned by uid 1001): back up /opt/app or snapshot the volume before upgrades. To add a person: sudo htpasswd -B /etc/apache2/perimattic-grist.htpasswd person@example.com (the user name must be their email address). Scripts use the same login: curl -u 'login:password' https://<your-domain>/api/orgs. Do not publish port 8484 or remove the Apache site: Grist trusts the user name Apache passes to it.
Thank you for subscribing.
Need Support or Customization? Perimattic's team can help with setup issues, custom features and integrations:
Email us: aws-support@perimattic.com WhatsApp: +91-92142 66896 Learn more: <www.perimattic.com >
We offer free setup assistance, custom development and integrations, and infrastructure consulting.
Resources
Vendor resources
Support
Vendor support
Support by Perimattic
Perimattic provides 24/7 support for all AWS Marketplace products. Our team has 13+ years of cloud infrastructure expertise serving global clients.
Contact Channels: Email: aws-support@perimattic.com WhatsApp: +91-92142 66896 Website: <www.perimattic.com >
What We Help With: Initial setup and configuration assistance (free) Troubleshooting connectivity, performance, and backup issues Custom development and integrations Infrastructure consulting and architecture review Migration planning from other solutions Automation solutions and scaling guidance
Instance Sizing Guidance: t2.medium or t3.medium: Development environments, small applications m5.large: Production workloads with moderate traffic m5.xlarge: High-traffic production deployments and larger datasets
For workload-specific sizing recommendations, contact our team for a free consultation.
Refunds and Issues: If you experience any issues or need to request a refund, contact us at aws-support@perimattic.com and we 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.