Usage Instructions for AWS users: Orthanc DICOM Server with AWS-S3 support

Usage Instructions for AWS users.

If CloudFormation template delivery method is used:

An AWS S3 bucket will be created to store files, and Orthanc will be automatically configured to work with it.

To deploy the Orthanc server under your domain or subdomain (already present in your Route 53 Hosted Zone), simply specify the domain name in the CloudFormation template parameters - all necessary server and Route 53 configurations will be handled automatically. A free SSL certificate from Let's Encrypt with automatic renewal will also be installed.

If the Standalone AMI delivery method is used:

If the Elastic IP was assigned to a running instance, the instance must be restarted.

In order to use AWS S3 bucket for data storage, you will need to modify the configuration file and enable the corresponding plugin manually.

The Orthanc server's web interface will be accessible via its IP address over HTTPS, with a self-signed certificate generated for it. You will be able to point your own domain to this server later.

Usage instructions:

Linux username: admin

After startup, the server is immediately ready for use, and its web interface is available by IP address or domain:

Web interfaces:
"Old" (classic): https://[Public IP address or Domain]:8042
"New" web interface: https://[Public IP address or Domain]:8042/ui/app/
(default username: admin; initial password is your instance ID)

When using the HTTPS protocol to access the web interface, your web browser may display a warning about potential risks due to using an IP address in the URL. In this case, you can proceed and accept the risks, as our main objective is to encrypt traffic, and using an IP address in a web browser is safe for our purposes.

Although the server is working after launching, it is recommended to view and configure configuration files for your tasks:
Configuration files of the server and its plugins are located in the directory: /etc/orthanc/
The main configuration file of the Orthanc server: /etc/orthanc/orthanc.json

After editing the configuration files, please do not forget to restart the Orthanc main service:
"sudo systemctl restart orthanc".

If you plan to connect this server with other servers, it is convenient to use the "Connectivity-checks" plugin to configure this server and monitor the status of the connections. To check the status of connections, please navigate to the plugins page in Orthanc Explorer and click on "Connectivity-checks" item.

If the server has been launched using the standalone AMI delivery option and you wish to use an AWS S3 bucket for file storage, you can enable the AWS S3 plugin manually:
1. Please edit the file "/etc/orthanc/aws-s3.json" (for example, using a command "sudo nano /etc/orthanc/aws-s3.json").
2. Run the command "bash /home/admin/s3enable.sh" to activate AWS S3 plugin. (To deactivate this plugin you can run command "bash /home/admin/s3disable.sh")
3. Make sure that AWS S3 plugin appeared in the plugin list ("Plugin" button in the Orthanc Explorer)
4. To test the functionality of the S3 plugin, please upload the some test studies from your PC ("Upload" button in Orthanc Explorer) and make sure the new files appear in your S3 bucket.

For more detailed information regarding Orthanc, visit:
https://book.orthanc-server.com/index.html

Try this server on AWS !