Overview
This AMI runs BookStack, the open-source wiki and documentation platform, with MariaDB on Ubuntu 24.04 LTS. BookStack publishes no official container image, so this AMI uses the community-maintained LinuxServer image (lscr.io/linuxserver/bookstack, release v26.09.2-ls295), with MariaDB 11.8.9 from the official image, both pinned and baked into the AMI so first start does not depend on a registry. The image is maintained by LinuxServer, not by the BookStack project. BookStack is an independent open-source project and Perimattic is not affiliated with it; product names are trademarks of their respective owners.
Why BookStack?
BookStack organises documentation in Shelves, Books, Chapters and Pages, with a WYSIWYG and a Markdown editor, full-text search, page revisions, roles and permissions, an API and optional LDAP, SAML or OIDC sign-in.
What Perimattic adds
No default login: a stock BookStack ships a built-in administrator, admin@admin.com with the password 'password', and the first person to find the site can use it. During first-login setup this AMI replaces that account with the email you enter and a random 24-character password generated on your server, before the site is published, and then checks that admin@admin.com no longer works, that a wrong password is refused, that registration is closed and that nothing is readable without logging in. The application key and database passwords are generated per instance. There are no default or shared credentials in the image.
HTTPS: Apache is configured as a reverse proxy and a free Let's Encrypt certificate is requested for your domain with certbot; BookStack's APP_URL is set to your domain and its session cookie is marked secure. BookStack listens only on the loopback interface and MariaDB is reachable only inside the Docker network.
Patched base: Ubuntu 24.04 LTS built through an automated EC2 Image Builder pipeline, with security updates applied at build time.
Limits you should know
No mail server is configured, so BookStack cannot send invitations or password-reset emails: when you add users under Settings, then Users, choose 'Set a password'. Set the MAIL_* variables in /opt/app/docker-compose.yml to enable email. Gravatar and other external services are switched off (DISABLE_EXTERNAL_SERVICES), so BookStack makes no outside calls. Public registration and public viewing are off, but you can turn them on in Settings.
BookStack is light: about 90 MB of memory and about 140 to 160 MB for MariaDB in our tests, with the instance at about 0.7 GB in use, so a t3.small (2 GB) is the recommended starting size.
Licence
BookStack is released under the MIT licence. The LinuxServer image packaging is GPL-3.0 licensed. MariaDB server is released under the GPL v2.
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 that email and the password printed at the end of setup
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
- BookStack 26.09.2 (MIT) with MariaDB 11.8.9, pinned and pre-installed: a self-hosted wiki for your documentation. Community LinuxServer image.
- Secure first login: BookStack's built-in admin@admin.com / password login is replaced by your email and a random 24-character password before the site is published; registration closed; 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
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
- ...
Dimension | Cost/hour |
|---|---|
t3.small 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: BookStack 26.09.2 (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.
- BookStack's built-in admin@admin.com / password login is replaced at first login with the buyer's email and a random 24-character password before the site is published; setup verifies that the old login no longer works, that a wrong password is refused, that registration is closed and that nothing is readable anonymously.
- Application: BookStack 26.09.2 from the community-maintained linuxserver.io image lscr.io/linuxserver/bookstack v26.09.2-ls295 (BookStack MIT; image packaging GPL-3.0) with MariaDB 11.8.9 (both pinned). The image is maintained by linuxserver.io, not by the BookStack project. The application key is generated per instance; Gravatar and the hosted diagrams.net editor are off.
- No SMTP is configured (no invitation or password-reset emails).
- Database: reachable only inside the Docker network.
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.small (2 GB of memory) is the recommended starting size: BookStack used about 90 MB and MariaDB about 140 to 160 MB in our tests. Choose t3.medium or larger for many users or large attachments.
-
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 BookStack
-
Point a domain at the instance
Create a DNS A record (for example wiki.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 admin password, the database passwords and the application key on your server
- Starts MariaDB and BookStack and replaces BookStack's built-in admin@admin.com / password login with your email and the generated password
- Checks that the old login no longer works, that a wrong password is refused, that registration is closed and that nothing is readable without logging in
- Configures Apache as an HTTPS reverse proxy and requests a Let's Encrypt certificate
- Prints the URL and the admin credentials; 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 BookStack
Open https://<your-domain> and sign in with the admin email you entered and the generated password (view it again with: sudo cat /opt/app/access.txt). The built-in admin@admin.com login no longer exists.
-
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
Content is in the MariaDB database in /opt/app/mariadb and uploads and settings in /opt/app/config: back up all of /opt/app or snapshot the volume before upgrades, and keep the application key from /opt/app/.env with the backup. No mail server is configured: choose 'Set a password' when creating users, or set the MAIL_* variables in /opt/app/docker-compose.yml. The container image is the community-maintained linuxserver.io image, not an image from the BookStack project.
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.