{"id":13514986,"url":"https://github.com/uoregon-libraries/rais-image-server","last_synced_at":"2026-02-28T14:30:25.615Z","repository":{"id":31933358,"uuid":"35502871","full_name":"uoregon-libraries/rais-image-server","owner":"uoregon-libraries","description":"RAIS: A IIIF-compliant, 100% open source image server for blazing-fast deep zooming","archived":false,"fork":false,"pushed_at":"2026-02-16T19:10:17.000Z","size":5525,"stargazers_count":81,"open_issues_count":11,"forks_count":7,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-02-17T01:56:29.491Z","etag":null,"topics":["golang-application","iiif","image-server","jp2","jpeg2000","tile-server","zoomable-images"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/uoregon-libraries.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-05-12T17:34:18.000Z","updated_at":"2026-02-16T19:10:18.000Z","dependencies_parsed_at":"2024-02-20T00:29:38.781Z","dependency_job_id":"fdfeb654-e215-4982-9af7-6e2ce5e39100","html_url":"https://github.com/uoregon-libraries/rais-image-server","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/uoregon-libraries/rais-image-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uoregon-libraries%2Frais-image-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uoregon-libraries%2Frais-image-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uoregon-libraries%2Frais-image-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uoregon-libraries%2Frais-image-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uoregon-libraries","download_url":"https://codeload.github.com/uoregon-libraries/rais-image-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uoregon-libraries%2Frais-image-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29937391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-28T13:49:17.081Z","status":"ssl_error","status_checked_at":"2026-02-28T13:48:50.396Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang-application","iiif","image-server","jp2","jpeg2000","tile-server","zoomable-images"],"created_at":"2024-08-01T05:01:04.950Z","updated_at":"2026-02-28T14:30:25.552Z","avatar_url":"https://github.com/uoregon-libraries.png","language":"Go","funding_links":[],"categories":["Go","Image Servers"],"sub_categories":["IIIF Extensions"],"readme":"[![Go Report Card](https://goreportcard.com/badge/github.com/uoregon-libraries/rais-image-server)](https://goreportcard.com/report/github.com/uoregon-libraries/rais-image-server)\n\nRodent-Assimilated Image Server\n=======\n\n![Gocutus, the RAIS mascot](gocutus.png?raw=true \"Gocutus, the RAIS mascot\")\n\nRAIS was originally built by [eikeon](https://github.com/eikeon) as a 100% open\nsource, no-commercial-products-required, proof-of-concept tile server for JP2\nimages within [chronam](https://github.com/LibraryOfCongress/chronam).\n\nIt has been updated to allow more command-line options, more source file\nformats, more features, and conformance to the [IIIF](http://iiif.io/) spec.\n\nRAIS is very efficient, completely free, and easy to set up and run.  See our\n[wiki](https://github.com/uoregon-libraries/rais-image-server/wiki) pages for\nmore details and documentation.\n\nConfiguration\n-----\n\n### Main Configuration Settings\n\nRAIS uses a configuration system that allows environment variables, a config\nfile, and/or command-line flags.  See [rais-example.toml](rais-example.toml)\nfor an example of a configuration file.  RAIS will use a configuration\nfile if one exists at `/etc/rais.toml`.\n\nThe configuration file's values can be overridden by environment variables,\nwhile command-line flags will override both configuration files and\nenvironmental variables.  Configuration is best explained and understood by\nreading the example file above, which describes all the values in detail.\n\n### Cloud Settings\n\nBecause connecting to a cloud provider is optional, often means using a\ncontainer-based setup, and differs from one provider to the next, all RAIS\ncloud configuration is environment-only.  This means it can't be specified on\nthe command line or in `rais.toml`.\n\nCurrently RAIS can theoretically support S3, Azure, and Google Cloud backends,\nbut only S3 has had much testing.  To set up RAIS for S3, you would have to\nexport the following environment variables (in addition to having an\nS3-compatible object store running):\n\n- `AWS_ACCESS_KEY_ID`: Required\n- `AWS_SECRET_ACCESS_KEY`: Required\n- `AWS_REGION`: Required\n- `RAIS_S3_ENDPOINT`: optionally set for custom S3 backends; e.g., \"minio:9000\"\n- `RAIS_S3_DISABLESSL`: optionally set this to \"true\" for custom S3 backends\n  which don't need SSL (for instance if they're running on the same server as\n  RAIS)\n- `RAIS_S3_FORCEPATHSTYLE`: optionally set this to \"true\" to force path-style\n  S3 calls.  This is typically necessary for custom S3 backends like minio, but\n  not for AWS.\n\nOther backends have their own environment variables which have to be set in\norder to have RAIS connect to them.\n\nFor a full demo of a working custom S3 backend powered by minio, see `docker/s3demo`.\n\n**Note** that external storage is going to be slower than serving images from\nlocal filesystems!  Make sure you test carefully!\n\nIIIF Features\n-----\n\nRAIS supports level 2 of the IIIF Image API 2.1 as well as a handful of\nfeatures beyond level 2.  See\n[the IIIF Features wiki page](https://github.com/uoregon-libraries/rais-image-server/wiki/IIIF-Features)\nfor an in-depth look at feature support.\n\nCaching\n-----\n\nRAIS can internally cache the IIIF `info.json` requests and individual tile\nrequests.  See the [RAIS Caching](https://github.com/uoregon-libraries/rais-image-server/wiki/Caching)\nwiki page for details.\n\nGenerating tiled, multi-resolution JP2s\n---\n\nRAIS performs best with JP2s which are generated as tiled, multi-resolution\n(think \"zoom levels\") images.  Generating images like this is fairly easy with\neither the openjpeg tools or graphicsmagick.  Other tools probably do this\nwell, but we've only directly used those.\n\nYou can find detailed instructions on the\n[How to encode jp2s](https://github.com/uoregon-libraries/rais-image-server/wiki/How-To-Encode-JP2s)\nwiki page.\n\nLicense\n-----\n\n\u003cimg src=\"http://i.creativecommons.org/p/zero/1.0/88x31.png\" style=\"border-style: none;\" alt=\"CC0\" /\u003e\n\nRAIS Image Server is in the public domain under a\n[CC0](http://creativecommons.org/publicdomain/zero/1.0/) license.\n\nContributors\n-----\n\nSpecial thanks to Jessica Dussault (@jduss4) for providing the hand-drawn\n\"Gocutus\" logo, and Greg Tunink (@techgique) for various digital refinements to\nsaid logo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuoregon-libraries%2Frais-image-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuoregon-libraries%2Frais-image-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuoregon-libraries%2Frais-image-server/lists"}