Install Koha on AWS Cloud – In Minutes, Not Days
Deploying the Koha Integrated Library System on AWS is fast, easy, and secure. Whether you’re a first-time user or familiar with AWS, this guide walks you through the process in just a few steps.
No Linux expertise needed – just launch, configure, and start managing your library.
Get Started in 3 Simple Steps
Step 1
Subscribe to the Koha AMI on the AWS Marketplace using this link. You will be prompted to create a free account if you do not already have one.
Step 2
Start your free trial and create a virtual server using the Koha AMI. It will take a minute or two for the server to startup.
Open the staff page and complete the post-installation setup to configure your Koha instance using these instructions.
Step 3
Login to Koha instance staff page using the username and password you created in the previous step. Your patrons will be able to access the catalog and manage their accounts via the OPAC page.
The deployment process is described in more detail below
Choose Your Deployment Method
We offer two easy ways to deploy Koha:
Option1: AWS Marketplace (Recommended)

Option 2: EC2 Console (Advanced)

Deploying Koha via the AWS Marketplace
Use the following steps to launch Koha via the AWS Marketplace
1
Subscribe to the Koha AMI
- Go to KohaSupport’s product catalog on the AWS Marketplace.
- Select either Koha Library System x86_64 or ARM64 (recommended, usually has cheaper instances).
- Review the pricing and usage terms.
- Click “Continue to Subscribe”, then Accept Terms.
- After a few moments, your subscription will be activated.
- Follow the guided launch wizard to begin configuring your Koha server.
2
Configure Your Instance
When the server is running:
- Make a note of the public IP address of your Koha server. You will use this to access your staff and OPAC pages.
- Retrieve your post-installation username and password by logging into to the EC2 instance. Step-by-step instructions can be found here Koha Library System Initial Post-Installation Setup
- Go to
http://<YOUR-EC2-INSTANCE-IP>:8080
and complete the post-installation setup. This includes choosing your cataloging framework (MARC21/UNIMARC), creating your library, defining patron categories, item types and creating the Koha administrator user (superlibrarian).
3
Launch and Access Koha
Deploying Koha via the AWS EC2 Console
Follow these steps to launch Koha using the EC2 console for more control over configuration.
1
Select the Koha AMI
- Log into your AWS account
- Navigate to the EC2 console to begin the instance launch process.
- Search for and select the Koha library system AMI by KohaSupport from the AWS Marketplace. You will be prompted to subscribe to the product if you haven not already done so.
2
Configure the Server
- When the server is running, make a note of the public IP address of your Koha server. You will use this to access your staff and OPAC pages.
- Retrieve your post-installation username and password by logging into to the EC2 instance. Step-by-step instructions can be found here Koha Library System Initial Post-Installation Setup
- Go to http://<YOUR-EC2-INSTANCE-IP>:8080 and complete the post-installation setup. This includes choosing your cataloging framework (MARC21/UNIMARC), creating your library, defining patron categories, item types and creating the Koha administrator user (superlibrarian).
3
Login to Koha
Koha on AWS Cloud FAQs
Find answers to common questions about launching and configuring Koha instances.
How do I retrieve the username and password for the administrator?
-
-
- Go to the AWS EC2 console
- Select the instance running your Koha library server
- Click "Connect" on the top right menu
- The default SSH username is ubuntu.
- In the terminal run the following command
sudo koha-passwd library
- Copy and save the username and password. You will need them for the initial setup.
-
What is the recommended instance type for Koha?
For optimal performance, we recommend using an instance type with at least 2 vCPUs and 4 GiB of RAM. Larger libraries may require more resources.
We provide two architecture options for each AMI: x86_64 and ARM64. If you don’t have a specific preference, we recommend choosing the ARM64 AMI. Instances such as the t4g family (which are ARM64-based) typically offer better performance at a lower cost compared to their x86 counterparts.
How do I configure security groups for Koha?
Ensure your security groups allow access to ports 80 and 8080 for the OPAC and staff pages, respectively. Open port 22 for SSH access only when necessary.
Gaining access to your server through the SSH port can pose significant security risks. Most users rarely need SSH access, and when they do, it's typically only for a short period of time. To help secure your server, we recommend the following best practices:
-
Restrict SSH access to specific IP addresses: In the security group rule, specify the IP addresses that are allowed to access the SSH port. This limits access to trusted sources only.
-
Remove the SSH rule when it's no longer needed: After using SSH, delete the security group rule that opens the SSH port. You can always recreate it from the console the next time you need access.
By following these steps, you can reduce the risk of unauthorized access to your server and keep your environment secure.
Can I use a custom domain with Koha?
Yes, you can configure a static IP for your instance and map it to a custom domain for seamless access to your Koha OPAC and staff client. To do this, you will need to SSH into your Koha server and modify the Apache configuration to respond to your custom domains.
Steps to configure your Koha server for custom domains:
-
Login to your Koha server via SSH
Use your SSH client to access your Koha server. -
Edit the Koha Apache2 configuration file
Open thelibrary.conf
file in your preferred text editor: -
Modify the virtual host settings for OPAC and Staff pages
Update the configuration so that it reflects your custom domains for the OPAC and staff client. For example:-
OPAC (Public) Domain Configuration:
-
Staff (Intranet) Domain Configuration:
Important Notes:
-
Port 80 should be used for both the OPAC and staff clients (default for HTTP). Previously, port 8080 was used for the staff client, but it is now replaced by port 80.
-
Update the
ServerName
directive to match your desired URLs, such asopac.example.com
for the OPAC page andstaff.example.com
for the staff interface.
-
-
Update Apache Listener Configuration
Ensure that Apache is listening on the correct ports. Open theport.conf
file:-
Remove any reference to port 8080 and ensure Apache is only listening on port 80:
-
-
Restart Apache to apply changes
After making these changes, restart Apache to ensure the new configuration is applied:
By following these steps, you’ll configure your Koha server to use custom domains for both the OPAC and staff interfaces, all running over the standard HTTP port (80). This improves accessibility and simplifies the user experience.
How do I manage my Koha subscription?
You can manage your subscription through the AWS Marketplace console under 'Manage subscriptions'. Here, you can view details and make changes as needed.
What is Koha?
What is Koha?
Koha is the first open-source library automation software and is widely used across the globe. It is developed and maintained by a growing community of users and developers who collaborate to meet their technological needs. As an enterprise-class Integrated Library System (ILS), Koha continues to evolve with new features and improvements, making it a powerful tool for libraries of all sizes.
Key Features of Koha:
-
Full-featured ILS: Koha provides a comprehensive set of modules that support library operations such as acquisitions, circulation, cataloging, serials management, authorities, flexible reporting, label printing, multi-format notices, offline circulation, and much more. Koha is scalable and can be used by single-branch libraries as well as consortia with multiple branches.
-
Multilingual and Translatable: Koha supports multiple languages and continues to add new ones, making it a truly global solution.
-
Powerful Search Functionality: Koha offers advanced search capabilities, including integration with external content sources like Amazon, Google, LibraryThing, Open Library, and Syndetics. This enhances your catalog's visibility and access to diverse content.
-
Library Standards Compliant: Built using industry standards such as MARC 21, UNIMARC, z39.50, SRU/SW, SIP2, and NCIP, Koha ensures interoperability with other systems while maintaining support for existing workflows and tools.
-
Web-based Interfaces: Koha’s OPAC, circulation, management, and self-checkout interfaces are based on web standards like XHTML, CSS, and JavaScript, providing a platform-independent solution that is accessible from any modern browser.
-
Free and Open Source: Koha is distributed under the GNU General Public License (GPL) version 3 or later, meaning libraries can freely access, modify, and share the software without any licensing fees.
-
No Vendor Lock-in: Koha’s open-source nature ensures there is no vendor lock-in. Libraries have the freedom to install and use Koha on their own, or purchase support and development services from any provider. You are not tied to any single vendor and can change support companies or migrate your data whenever needed.
-
Support Options: While Koha is free to use, libraries can opt for support services, including custom development, training, and troubleshooting, to meet their unique need
Can I get a free trial?
Can I get a free trial?
Yes, we offer a 14-day free trial for Koha on AWS Cloud, allowing you to test its features and see how it can improve your library's operations before committing.
How do I get started launching Koha on AWS Cloud?
How do I get started launching Koha on AWS Cloud?
Getting started is easy! Simply follow our step-by-step guide to launch Koha on AWS. The process is designed to be simple, with clear instructions and minimal setup required.
How much does it cost?
Our Koha AMIs are priced at $999 per year, with the option for hourly, pay-as-you-go pricing. This cost is significantly lower than other vendors, both open-source and commercial, which can charge up to $33,000 per library. We keep overhead costs low to ensure you receive the best value without compromising on quality.
Please note that the cost of infrastructure (e.g., EC2 servers) is determined and paid directly to AWS. We only offer the software (the AMI), so it’s important to choose the right instance type to ensure an optimal balance of price and performance.
Additionally, we offer paid support with the initial setup and configuration, as well as technical support, data migration, and training services through the AWS Marketplace to help you get the most out of your Koha setup.
What support options are available for Koha AMIs?
We offer a range of support options to ensure you have everything you need for a smooth experience with Koha on AWS:
-
Initial Setup and Configuration: We assist with the initial deployment, configuration, and customization of your Koha AMI to get your library up and running quickly. This support is available through the AWS Marketplace.
-
Technical Support: If you encounter issues or need troubleshooting assistance, we provide ongoing technical support. Whether it's solving problems or answering questions, we’re here to help you resolve any challenges.
-
Data Migration: We offer data migration services to help you import your existing bibliographic, authority, and patron records from other systems into Koha. Our team will ensure a seamless transition from your current software to Koha.
-
Training Services: If your team needs guidance on how to use Koha effectively, we provide training services tailored to your needs. This includes setting up workflows, managing circulation, and maximizing the system’s capabilities.
-
Custom Development: For libraries with unique needs, we offer custom development services to tailor Koha to your specific requirements.
All of these services are available via the AWS Marketplace Professional Services page, where you can request a quote or inquire about support options.
Can I get a discount?
Because we have already made the cost as low as possible, we are unable to offer discounts. Other vendors, both open-source and commercial, charge as much as $33,000 per library. We ensure affordability by keeping overhead costs low, so libraries like yours can benefit from a high-quality solution at a fraction of the price.
In addition to our already low prices, you can further reduce your costs by:
-
Taking advantage of our 14-day trial: Test Koha and its features before committing to the full subscription.
-
Using AWS Free Tier instances: If you are new to AWS, you can use AWS Free Tier instances for the first 12 months, which allows you to launch your server without incurring additional infrastructure costs. You’ll only pay for the AMI costs during this period.
-
Paying the AMI fees upfront: Opting for the annual subscription instead of the hourly option can save you up to 33% in the first year.
These options provide flexibility and cost savings while ensuring you get the best value from Koha on AWS.
Do I need technical expertise to set up Koha?
No, you do not need prior technical knowledge. Our step-by-step process is designed to be easy to follow, even for users with limited technical expertise. You can have Koha up and running in just a few minutes! However, if you find that you need help at any point, you can make a support request via our AWS Marketplace Professional Services page. We will be happy to assist you with any requirements you have.
How do I migrate data from my current library system to Koha?
We offer data migration services to help you import bibliographic, authority, and patron records from your current library system into Koha. Our team will work with you to ensure a smooth transition. Please reach out via the AWS Marketplace Professional Services page for more details.
What are the hardware requirements for running Koha on AWS?
For optimal performance, we recommend using an instance type with at least 2 vCPUs and 4 GiB of RAM. Larger libraries may need more resources. Choose the right instance type based on your library’s needs to ensure a balance of cost and performance.
Can I use Koha for a multi-branch library?
Yes, Koha is fully capable of supporting multi-branch libraries. It offers flexible features for managing multiple locations, ensuring that you can maintain seamless operations across all branches.
Is Koha compatible with RFID systems for self-checkout?
Yes, Koha supports integration with RFID systems for self-checkout. You can configure your Koha system to work with compatible hardware and provide a self-service experience for your patrons.
Can I customize the look and feel of the OPAC (Online Public Access Catalog)?
Yes, Koha allows you to customize the OPAC to match your library’s branding. You can modify themes, templates, and even implement custom features to tailor the OPAC to your needs.
What is the backup and recovery process for Koha on AWS?
Koha automatically performs daily backups of your database and configuration, saving them in the folder /var/spool/koha/library on your server. Additionally, you can use the Export Data tool in the Koha console to download backups manually.
To further protect your data, you can store these backups in external storage locations such as Amazon S3, Google Drive, Dropbox, or locally on a USB stick or external hard drive.
Koha on AWS is fully compatible with AWS backup and recovery tools, including AWS Backup. We strongly recommend setting up automated backups to ensure your data is consistently protected and can be easily restored in case of issues.
Can I configure Koha to work with other library systems?
Yes, Koha supports interoperability with many library systems and third-party applications through industry-standard protocols like MARC 21, UNIMARC, Z39.50, and SRU/SW. If you need to integrate Koha with another system, we can help you configure and customize the setup to meet your needs.
How secure is Koha on AWS?
Koha on AWS benefits from AWS's robust security infrastructure, including network isolation, encryption at rest and in transit, and regular security updates. Additionally, you can implement custom security measures, such as VPC configurations, security groups, and IAM roles, to further protect your library’s data.
Can I use Koha for both academic and public libraries?
Yes, Koha is versatile and can be used by both academic and public libraries. It offers specific modules and features that cater to the needs of both types of libraries, including circulation management, cataloging, and user access controls.
How do I get help if I need support with Koha?
If you need help with setup, configuration, or troubleshooting, we offer various support services through the AWS Marketplace. You can request assistance for technical support, data migration, or custom development through our Professional Services page, where you can also get a quote for your specific needs.
Can I use Koha for both academic and public libraries?
Yes, Koha is versatile and can be used by both academic and public libraries. It offers specific modules and features that cater to the needs of both types of libraries, including circulation management, cataloging, and user access controls.