Frequently Asked Questions

At KohaSupport, we understand that transitioning to the cloud can be daunting, but our resources are tailored to ensure a smooth migration. With our expertise in Koha and AWS Cloud, you can enhance your library’s operations and improve access for your patrons, enabling you to better serve your community. Explore our FAQs to maximise your Koha system’s capabilities and streamline your library experience.

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?
      1. Go to the AWS EC2 console
      2. Select the instance running your  Koha library server
      3. Click "Connect" on the top right menu
      4. The default SSH username is ubuntu.
      5. In the terminal run the following command sudo koha-passwd library
      6. 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:

  1. 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.

  2. 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:

  1. Login to your Koha server via SSH
    Use your SSH client to access your Koha server.

  2. Edit the Koha Apache2 configuration file
    Open the library.conf file in your preferred text editor:

    sudo nano /etc/apache2/sites-available/library.conf
    # or
    sudo vim /etc/apache2/sites-available/library.conf
  3. 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:

       
      <VirtualHost *:80>
      ...
      ServerName opac.example.com
      ...
      </VirtualHost>
    • Staff (Intranet) Domain Configuration:

       
      <VirtualHost *:80>
      ...
      ServerName staff.example.com
      ...
      </VirtualHost>

    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 as opac.example.com for the OPAC page and staff.example.com for the staff interface.

  4. Update Apache Listener Configuration
    Ensure that Apache is listening on the correct ports. Open the port.conf file:

     
    sudo nano /etc/apache2/ports.conf
    # or
    sudo vim /etc/apache2/ports.conf
    • Remove any reference to port 8080 and ensure Apache is only listening on port 80:

       
      Listen 80
  5. Restart Apache to apply changes
    After making these changes, restart Apache to ensure the new configuration is applied:

     
    sudo systemctl restart apache2

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.

Launch Your Library Into The Cloud with Koha on AWS