[{"_1":2,"_167":-5,"_168":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_142":143},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_135":-5,"_136":11,"_137":17,"_138":11,"_139":-5,"_140":141},"canonicalUrl","https://hub.docker.com/r/pooya/ipx/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","pooya","reponame","ipx","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2017-12-10T11:14:14.613793Z","description","🖼 High performance, secure and easy to use image proxy based on Sharp and libvips.","is_private","last_updated","2018-09-24T20:16:50.931478Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",477,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"IPX$ \n

\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/pooya/ipx.svg?style=flat-square)]()\n[![Docker Automated build](https://img.shields.io/docker/automated/pooya/ipx.svg?style=flat-square)]()\n[![Docker Build Status](https://img.shields.io/docker/build/pooya/ipx.svg?style=flat-square)]()\n\n> High performance, secure and easy to use image proxy based on [Sharp](https://github.com/lovell/sharp) and [libvips](https://github.com/jcupitt/libvips).\n\n✅ Fast and minimal as possible. \n✅ Easy deployment. \n✅ Configurable operations. \n✅ Built-in secure cache with human readable entries and resistant against duplicates. \n✅ Remote agnostic cache and input adapters. \n✅ Smart and auto cache cleaning. \n✅ Twelve factor friendly. \n✅ Client libraries for URL generation. \n\n

Clients

\n\n- [JS Client](./client/js/README.md) for Node.js and Browser.\n\n

API

\n\n**`/{format}/{operations}/{src}`**\n\nOperations are separated by a colon `,` (Example: `op1,op2`) and their arguments separated using underscore `_` (Example: `s_200_300`)\n\nََ‍‍Use `_` value in place for `{format}` or `{operations}` to keep original values of source image.\n\nPossible values for format: `jpeg`,`webp` or `png`.\n\n### Examples\n\nJust change format to `webp` and keep other things same as source:\n\n`http://cdn.example.com/webp/_/avatars/buffalo.png`\n\nKeep original format (`png`) and set width to `200`:\n\n`http://cdn.example.com/_/w_200/avatars/buffalo.png`\n\nResize to `200x300px` using `embed` method and change format to `jpg`:\n\n`http://cdn.example.com/jpg/s_200_300,embed/avatars/buffalo.png`\n\n

Docker deployment

\n\nLatest docker image is automatically built under [pooya/ipx](https://hub.docker.com/r/pooya/ipx).\n\nQuick start:\n\n```bash\ndocker run \\\n -it \\\n --rm \\\n --volume ./storage:/app/storage:ro \\\n --volume ./cache:/app/cache \\\n --port 3000:3000\n pooya/ipx\n```\n\nUsing docker-compose:\n\n```yml\n image: pooya/ipx\n volumes:\n - ./storage:/app/storage:ro\n - ./cache:/app/cache\n ports:\n - 3000:3000\n```\n\n

Operations

\n\nOperation | Arguments | Example | Description\n-------------|-----------------------|-------------|---------------------------------------------------------\n`s` | `width`, `height` | s_200_300 | Resize image.\n`w` | `width` | w_200 | Change image with.\n`h` | `height` | h_200 | Change image height.\n`embed` | - | embed | Preserving aspect ratio, resize the image to the maximum `width` or `height` specified then embed on a background of the exact `width` and `height` specified.\n`max` | - | max | Preserving aspect ratio, resize the image to be as large as possible while ensuring its dimensions are less than or equal to the `width` and `height` specified.\n`min` | - | min | Preserving aspect ratio, resize the image to be as small as possible while ensuring its dimensions are greater than or equal to the width and height specified.\n\n

Config

\n\nConfig can be customized using `IPX_*` environment variables or `config/local.js` file. Here are defaults:\n\n```js\n ipx: {\n input: {\n adapter: 'IPX_INPUT_ADAPTER', // Default: fs.js\n dir: 'IPX_INPUT_DIR' // Default: storage\n },\n cache: {\n adapter: 'IPX_CACHE_ADAPTER', // Default: fs.js\n dir: 'IPX_CACHE_DIR', // Default: cache\n cleanCron: 'IPX_CACHE_CLEAN_CRON', // Default: 0 0 3 * * * (every night at 3:00 AM)\n maxUnusedMinutes: 'IPX_CACHE_CLEAN_MINUTES' // Default: 24 * 60 (24 hours)\n }\n }\n```\n\n

License

\n\nMIT - Pooya Parsa\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",1099957506,"orgData","recentTags",[87,125],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",379608,"full_size",286764565,"id",19195866,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:770864521f9b1d441ec7f8e47dfe79fcf7d49ea3584af725d1bfe44591d438e8","features","","last_pulled","2026-09-18T00:18:34.457393497Z","last_pushed","2017-12-16T17:36:02Z","os","linux","os_features","os_version","size","variant","2017-12-16T17:36:01.754758Z","last_updater","last_updater_username","media_type","latest","repository",2353618,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":126,"_93":127,"_95":128,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},283591635,35957136,[129],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},"sha256:1440780d6da010618d40064e8d781cbe3709de07f25e02c65da0b5087ff77334","2026-09-18T00:15:27.694914463Z","2018-09-24T20:16:48Z","2018-09-24T20:16:47.723835Z","renovate_configure","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":144,"_151":152,"_140":165,"_166":11},{"_36":145,"_38":146,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":147,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":148,"_75":17,"_76":150,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":149},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_153":154,"_155":-5,"_156":-5,"_157":158},"count",2,"next","previous","results",[159,162],{"_88":40,"_89":90,"_91":126,"_93":127,"_95":160,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},[161],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},{"_88":40,"_89":90,"_91":92,"_93":94,"_95":163,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[164],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

pooya/ipx

Tags for pooya/ipx