• Log in to your AWS account and navigate to the EC2 dashboard.
• In the EC2 console, select your new instance listed under “Instances”

SSH into your instance:

– Via the EC2 console: Open the EC2 console > Select the instance > Go to connect >  “Connect using EC2 Instance Connect” > Use “ubuntu” as the username.

– Via an SSH client: To connect using your IDE (integrated development environment), you can use the public IP address or public DNS provided in the console. Use “ubuntu” as the username. You will also need to specify the private key file associated with the key pair you selected when launching the instance.

Retrieve the Koha administrator password and username by running the following commands:

# List the Koha instances
koha-list 

# Retrieve the password for the instance named "library"
sudo koha-passwd library 

• Copy the instance public IP address or public DNS and paste it into your web browser.
• Use port 8080 (i.e, https://<YOUR-INSTANCE-IP-ADDRESS>:8080). Make sure to use http, not https.) to access the staff client, unless you have already configured an SSL certificate on the server. You will be redirected to the post-installation setup wizard.
• Log in with the username “koha_library” and the password you retrieved earlier.

• Select your language and click “Continue to the next step”.
• Click “Continue to the next step” after the Perl dependencies check.
• Click “Continue to the next step” after the database settings check.
• Click “Continue to next step” after the database connection check. 
• Click “Continue to next step” after the database setup. 
• Click “Continue to next step” to install basic configuration settings. 
• Select your MARC flavour and click “Continue to next step”. 
• Select the mandatory and optional settings you want to install. Note that the following steps only apply if you select all the mandatory and optional settings, which is helpful when you want to quickly test Koha. However, for production, we recommend at least leaving the “Sample libraries”, Sample patrons”, and “Sample news items” unchecked. 
• The default data will be loaded into your database. Click “Setup some of Koha’s basic requirements”.

• The default data will be loaded into your database. Click “Setup some of Koha’s basic requirements”. 
• Click “Begin the onboarding process” 
• Enter the details for your super-librarian user. 
• Configure the circulation rules. 
• Click submit and you will be redirected to the staff client login page.
• Log in with the super-librarian credentials you just created. Note: You might be redirected to the post-installation setup page. If this happens, go to the browser address bar and remove everything after “https://<YOUR-INSTANCE-IP-ADDRESS>:8080”

• Using your staff (superlibrarian) username and password, login to the administration console.
• Navigate to the menu > “More” dropdown > “About Page” ed as missing or outdated when you initially log in. Wait a few moments and refresh the page to see if the status changes
  

• You will see crucial information about your Koha instance, dependencies, and configurations. This information is useful for troubleshooting and verifying that your system is up to date.
• Resolve any warnings or errors displayed on this page. If you encounter issues related to server information or Perl modules, refer to the Koha documentation or contact KohaSupport for assistance.
• The “Server information” section provides details about your server environment, including the operating system, Perl version, database information, and other software dependencies.

• The “Perl modules” section lists the Perl modules required for Koha to function correctly.
• Ensure that all required modules are installed and up to date. 
• Note: Sometimes, a module may be listed as missing or outdated when you initially log in. Wait a few moments and refresh the page to see if the status changes.

• The “System preferences” section displays the current system preferences set up during the installation process.
• You might see some warnings about missing or incorrect system preferences. Review and update these preferences by going to the “System preferences” page in the Koha administration interface.

Find answers to common questions about launching and configuring Koha instances.