[{"data":1,"prerenderedAt":1447},["ShallowReactive",2],{"navigation":3,"/docs/getting-started/choosing-an-image":229,"/docs/getting-started/choosing-an-image-surround":1442},[4],{"title":5,"path":6,"stem":7,"children":8},"Docs","/docs","docs",[9,12,56,85,132,153,186,203,216],{"title":10,"path":6,"stem":11},"","docs/index",{"title":13,"path":14,"stem":15,"children":16,"icon":55},"Getting Started","/docs/getting-started","docs/1.getting-started/1.index",[17,19,23,27,31,35,39,43,47,51],{"title":18,"path":14,"stem":15},"Introduction",{"title":20,"path":21,"stem":22},"Container Basics","/docs/getting-started/container-basics","docs/1.getting-started/2.container-basics",{"title":24,"path":25,"stem":26},"Installation","/docs/getting-started/installation","docs/1.getting-started/3.installation",{"title":28,"path":29,"stem":30},"These Images vs Others","/docs/getting-started/these-images-vs-others","docs/1.getting-started/4.these-images-vs-others",{"title":32,"path":33,"stem":34},"Choosing an Image","/docs/getting-started/choosing-an-image","docs/1.getting-started/5.choosing-an-image",{"title":36,"path":37,"stem":38},"Default Configurations","/docs/getting-started/default-configurations","docs/1.getting-started/6.default-configurations",{"title":40,"path":41,"stem":42},"Upgrade Guide","/docs/getting-started/upgrade-guide","docs/1.getting-started/7.upgrade-guide",{"title":44,"path":45,"stem":46},"Changelog","/docs/getting-started/changelog","docs/1.getting-started/8.changelog",{"title":48,"path":49,"stem":50},"About","/docs/getting-started/about","docs/1.getting-started/9.about",{"title":52,"path":53,"stem":54},"Contributing","/docs/getting-started/contributing","docs/1.getting-started/99.contributing",false,{"title":57,"path":58,"stem":59,"children":60,"page":55},"Image Variations","/docs/image-variations","docs/2.image-variations",[61,65,69,73,77,81],{"title":62,"path":63,"stem":64},"CLI","/docs/image-variations/cli","docs/2.image-variations/cli",{"title":66,"path":67,"stem":68},"FPM","/docs/image-variations/fpm","docs/2.image-variations/fpm",{"title":70,"path":71,"stem":72},"FPM-Apache","/docs/image-variations/fpm-apache","docs/2.image-variations/fpm-apache",{"title":74,"path":75,"stem":76},"FPM-NGINX","/docs/image-variations/fpm-nginx","docs/2.image-variations/fpm-nginx",{"title":78,"path":79,"stem":80},"FrankenPHP","/docs/image-variations/frankenphp","docs/2.image-variations/frankenphp",{"title":82,"path":83,"stem":84},"Unit (Deprecated)","/docs/image-variations/unit","docs/2.image-variations/unit",{"title":86,"path":87,"stem":88,"children":89,"page":55},"Framework Guides","/docs/framework-guides","docs/3.framework-guides",[90,123],{"title":91,"icon":55,"defaultOpen":55,"path":92,"stem":93,"children":94,"page":55},"Laravel","/docs/framework-guides/laravel","docs/3.framework-guides/1.laravel",[95,99,103,107,111,115,119],{"title":96,"path":97,"stem":98},"Automations","/docs/framework-guides/laravel/automations","docs/3.framework-guides/1.laravel/1.automations",{"title":100,"path":101,"stem":102},"Task Scheduler","/docs/framework-guides/laravel/task-scheduler","docs/3.framework-guides/1.laravel/2.task-scheduler",{"title":104,"path":105,"stem":106},"Queue","/docs/framework-guides/laravel/queue","docs/3.framework-guides/1.laravel/3.queue",{"title":108,"path":109,"stem":110},"Horizon","/docs/framework-guides/laravel/horizon","docs/3.framework-guides/1.laravel/4.horizon",{"title":112,"path":113,"stem":114},"Reverb","/docs/framework-guides/laravel/reverb","docs/3.framework-guides/1.laravel/4.reverb",{"title":116,"path":117,"stem":118},"Nightwatch","/docs/framework-guides/laravel/nightwatch","docs/3.framework-guides/1.laravel/5.nightwatch",{"title":120,"path":121,"stem":122},"Octane","/docs/framework-guides/laravel/octane","docs/3.framework-guides/1.laravel/octane",{"title":124,"icon":55,"defaultOpen":55,"path":125,"stem":126,"children":127,"page":55},"WordPress","/docs/framework-guides/wordpress","docs/3.framework-guides/2.wordpress",[128],{"title":129,"path":130,"stem":131},"Using Docker with WordPress","/docs/framework-guides/wordpress/using-wordpress-with-docker","docs/3.framework-guides/2.wordpress/4.using-wordpress-with-docker",{"title":133,"path":134,"stem":135,"children":136,"page":55},"Deployment And Production","/docs/deployment-and-production","docs/4.deployment-and-production",[137,141,145,149],{"title":138,"path":139,"stem":140},"Development to Production","/docs/deployment-and-production/development-to-production","docs/4.deployment-and-production/2.development-to-production",{"title":142,"path":143,"stem":144},"Packaging Your App for Deployment","/docs/deployment-and-production/packaging-your-app-for-deployment","docs/4.deployment-and-production/3.packaging-your-app-for-deployment",{"title":146,"path":147,"stem":148},"Configuring SSL","/docs/deployment-and-production/configuring-ssl","docs/4.deployment-and-production/4.configuring-ssl",{"title":150,"path":151,"stem":152},"Choosing a Host","/docs/deployment-and-production/choosing-a-host","docs/4.deployment-and-production/5.choosing-a-host",{"title":154,"icon":55,"defaultOpen":55,"path":155,"stem":156,"children":157,"page":55},"Advanced Guides","/docs/guide","docs/5.guide",[158,162,166,170,174,178,182],{"title":159,"path":160,"stem":161},"Migrating from official PHP images","/docs/guide/migrating-from-official-php-images","docs/5.guide/1.migrating-from-official-php-images",{"title":163,"path":164,"stem":165},"Using Healthchecks With Laravel","/docs/guide/using-healthchecks-with-laravel","docs/5.guide/2.using-healthchecks-with-laravel",{"title":167,"path":168,"stem":169},"Using S6 Overlay","/docs/guide/using-s6-overlay","docs/5.guide/2.using-s6-overlay",{"title":171,"path":172,"stem":173},"Understanding File Permissions","/docs/guide/understanding-file-permissions","docs/5.guide/3.understanding-file-permissions",{"title":175,"path":176,"stem":177},"Configuring Trusted Proxies","/docs/guide/configuring-trusted-proxies","docs/5.guide/4.configuring-trusted-proxies",{"title":179,"path":180,"stem":181},"Major version migrations","/docs/guide/major-version-migrations","docs/5.guide/5.major-version-migrations",{"title":183,"path":184,"stem":185},"Production performance tuning","/docs/guide/production-performance-tuning","docs/5.guide/6.production-performance-tuning",{"title":187,"icon":55,"defaultOpen":55,"path":188,"stem":189,"children":190,"page":55},"Customization","/docs/customizing-the-image","docs/6.customizing-the-image",[191,195,199],{"title":192,"path":193,"stem":194},"Changing php.ini settings","/docs/customizing-the-image/changing-common-php-settings","docs/6.customizing-the-image/1.changing-common-php-settings",{"title":196,"path":197,"stem":198},"Installing PHP extensions","/docs/customizing-the-image/installing-additional-php-extensions","docs/6.customizing-the-image/2.installing-additional-php-extensions",{"title":200,"path":201,"stem":202},"Adding Start Up Scripts","/docs/customizing-the-image/adding-your-own-start-up-scripts","docs/6.customizing-the-image/3.adding-your-own-start-up-scripts",{"title":204,"path":205,"stem":206,"children":207,"page":55},"Troubleshooting","/docs/troubleshooting","docs/7.troubleshooting",[208,212],{"title":209,"path":210,"stem":211},"Common Issues","/docs/troubleshooting/common-issues","docs/7.troubleshooting/1.common-issues",{"title":213,"path":214,"stem":215},"Getting Help","/docs/troubleshooting/getting-help","docs/7.troubleshooting/2.getting-help",{"title":217,"path":218,"stem":219,"children":220,"page":55},"Reference","/docs/reference","docs/8.reference",[221,225],{"title":222,"path":223,"stem":224},"Environment Variable Specification","/docs/reference/environment-variable-specification","docs/8.reference/1.environment-variable-specification",{"title":226,"path":227,"stem":228},"Command Reference","/docs/reference/command-reference","docs/8.reference/2.command-reference",{"id":230,"title":32,"body":231,"description":1436,"extension":1225,"links":1437,"meta":1438,"navigation":1439,"path":33,"redirect":1437,"seo":1440,"stem":34,"__hash__":1441},"docs/docs/1.getting-started/5.choosing-an-image.md",{"type":232,"value":233,"toc":1417},"minimark",[234,241,246,258,276,288,304,310,313,327,331,334,341,344,761,765,768,771,874,877,1064,1077,1113,1116,1119,1132,1141,1144,1147,1206,1209,1212,1228,1230,1233,1236,1240,1242,1245,1252,1256,1258,1261,1264,1268,1270,1273,1276,1280,1284,1294,1298,1301,1333,1373,1377,1390,1393,1413],[235,236,237],"lead-p",{},[238,239,240],"p",{},"Choosing an image might be a little intimidating because there are so many options, but this ultimately gives you a ton of flexibility. This guide will help simplify your decision making process on choosing the right image.",[242,243,245],"h2",{"id":244},"registry-where-images-are-located","Registry: Where images are located",[238,247,248,249,257],{},"Before diving into the different options available, let's understand where these images come from. The source code is ",[250,251,256],"a",{"href":252,"rel":253,"target":255},"https://github.com/serversideup/docker-php",[254],"nofollow","_blank","hosted on GitHub"," with an automated process that builds and uploads images to container registries:",[259,260,261,269],"ol",{},[262,263,264],"li",{},[250,265,268],{"href":266,"rel":267},"https://hub.docker.com/r/serversideup/php",[254],"Docker Hub",[262,270,271],{},[250,272,275],{"href":273,"rel":274},"https://github.com/serversideup/docker-php/pkgs/container/php",[254],"GitHub Packages",[238,277,278,279,283,284,287],{},"To use these images, you need to specify a certain \"tag\" for the image you want. For example, the ",[280,281,282],"code",{},"8.4"," version of the ",[280,285,286],{},"fpm-nginx"," variation is tagged as:",[289,290,294],"pre",{"className":291,"code":292,"language":293,"meta":10,"style":10},"language-bash shiki shiki-themes github-dark","serversideup/php:8.4-fpm-nginx\n","bash",[280,295,296],{"__ignoreMap":10},[297,298,301],"span",{"class":299,"line":300},"line",1,[297,302,292],{"class":303},"svObZ",[238,305,306,307,309],{},"This image gives you the latest stable patch version of PHP 8.4 running the ",[280,308,286],{}," variation. Since no registry is specified, it defaults to Docker Hub.",[238,311,312],{},"When selecting an image, you'll need to decide on:",[259,314,315,318,321,324],{},[262,316,317],{},"PHP version",[262,319,320],{},"PHP variation",[262,322,323],{},"Base operating system",[262,325,326],{},"serversideup/php version (for production environments)",[242,328,330],{"id":329},"our-most-popular-images","Our most popular images",[238,332,333],{},"All images are intelligently tagged with the PHP version and variation, allowing you to easily select the right image for your use case.",[238,335,336,337,340],{},"If you don't specify a variation, it defaults to ",[280,338,339],{},"cli"," and the latest supported Debian release for that variation.",[238,342,343],{},"Our most popular tags include:",[345,346,347,360],"table",{},[348,349,350],"thead",{},[351,352,353,357],"tr",{},[354,355,356],"th",{},"⚙️ Variation",[354,358,359],{},"🚀 Version",[361,362,363,457,542,587,671,749],"tbody",{},[351,364,365,368],{},[366,367,339],"td",{},[366,369,370,374,375,374,388,374,397,374,406,415,418,374,421,374,430,374,439,374,448],{},[371,372,373],"strong",{},"Debian Based"," ",[250,376,379],{"href":377,"rel":378},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-cli&page=1&ordering=-name",[254],[380,381],"img",{":zoom":382,"alt":383,"className":384,"src":387},"false","serversideup/php:8.5-cli",[385,386],"h-5","w-auto","https://img.shields.io/docker/image-size/serversideup/php/8.5-cli?label=serversideup%2Fphp%3A8.5-cli",[250,389,392],{"href":390,"rel":391},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-cli&page=1&ordering=-name",[254],[380,393],{":zoom":382,"alt":394,"className":395,"src":396},"serversideup/php:8.4-cli",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-cli?label=serversideup%2Fphp%3A8.4-cli",[250,398,401],{"href":399,"rel":400},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-cli&page=1&ordering=-name",[254],[380,402],{":zoom":382,"alt":403,"className":404,"src":405},"serversideup/php:8.3-cli",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-cli?label=serversideup%2Fphp%3A8.3-cli",[250,407,410],{"href":408,"rel":409},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-cli&page=1&ordering=-name",[254],[380,411],{":zoom":382,"alt":412,"className":413,"src":414},"serversideup/php:8.2-cli",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-cli?label=serversideup%2Fphp%3A8.2-cli",[416,417],"br",{},[371,419,420],{},"Alpine Based",[250,422,425],{"href":423,"rel":424},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-cli-alpine&page=1&ordering=-name",[254],[380,426],{":zoom":382,"alt":427,"className":428,"src":429},"serversideup/php:8.5-cli-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-cli-alpine?label=serversideup%2Fphp%3A8.5-cli-alpine",[250,431,434],{"href":432,"rel":433},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-cli-alpine&page=1&ordering=-name",[254],[380,435],{":zoom":382,"alt":436,"className":437,"src":438},"serversideup/php:8.4-cli-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-cli-alpine?label=serversideup%2Fphp%3A8.4-cli-alpine",[250,440,443],{"href":441,"rel":442},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-cli-alpine&page=1&ordering=-name",[254],[380,444],{":zoom":382,"alt":445,"className":446,"src":447},"serversideup/php:8.3-cli-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-cli-alpine?label=serversideup%2Fphp%3A8.3-cli-alpine",[250,449,452],{"href":450,"rel":451},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-cli-alpine&page=1&ordering=-name",[254],[380,453],{":zoom":382,"alt":454,"className":455,"src":456},"serversideup/php:8.2-cli-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-cli-alpine?label=serversideup%2Fphp%3A8.2-cli-alpine",[351,458,459,462],{},[366,460,461],{},"fpm",[366,463,464,374,466,374,475,374,484,374,493,502,504,374,506,374,515,374,524,374,533],{},[371,465,373],{},[250,467,470],{"href":468,"rel":469},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-fpm&page=1&ordering=-name",[254],[380,471],{":zoom":382,"alt":472,"className":473,"src":474},"serversideup/php:8.5-fpm",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-fpm?label=serversideup%2Fphp%3A8.5-fpm",[250,476,479],{"href":477,"rel":478},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-fpm&page=1&ordering=-name",[254],[380,480],{":zoom":382,"alt":481,"className":482,"src":483},"serversideup/php:8.4-fpm",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-fpm?label=serversideup%2Fphp%3A8.4-fpm",[250,485,488],{"href":486,"rel":487},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-fpm&page=1&ordering=-name",[254],[380,489],{":zoom":382,"alt":490,"className":491,"src":492},"serversideup/php:8.3-fpm",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-fpm?label=serversideup%2Fphp%3A8.3-fpm",[250,494,497],{"href":495,"rel":496},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-fpm&page=1&ordering=-name",[254],[380,498],{":zoom":382,"alt":499,"className":500,"src":501},"serversideup/php:8.2-fpm",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-fpm?label=serversideup%2Fphp%3A8.2-fpm",[416,503],{},[371,505,420],{},[250,507,510],{"href":508,"rel":509},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-fpm-alpine&page=1&ordering=-name",[254],[380,511],{":zoom":382,"alt":512,"className":513,"src":514},"serversideup/php:8.5-fpm-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-fpm-alpine?label=serversideup%2Fphp%3A8.5-fpm-alpine",[250,516,519],{"href":517,"rel":518},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-fpm-alpine&page=1&ordering=-name",[254],[380,520],{":zoom":382,"alt":521,"className":522,"src":523},"serversideup/php:8.4-fpm-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-fpm-alpine?label=serversideup%2Fphp%3A8.4-fpm-alpine",[250,525,528],{"href":526,"rel":527},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-fpm-alpine&page=1&ordering=-name",[254],[380,529],{":zoom":382,"alt":530,"className":531,"src":532},"serversideup/php:8.3-fpm-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-fpm-alpine?label=serversideup%2Fphp%3A8.3-fpm-alpine",[250,534,537],{"href":535,"rel":536},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-fpm-alpine&page=1&ordering=-name",[254],[380,538],{":zoom":382,"alt":539,"className":540,"src":541},"serversideup/php:8.2-fpm-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-fpm-alpine?label=serversideup%2Fphp%3A8.2-fpm-alpine",[351,543,544,547],{},[366,545,546],{},"fpm-apache",[366,548,549,374,551,374,560,374,569,374,578],{},[371,550,373],{},[250,552,555],{"href":553,"rel":554},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-fpm-apache&page=1&ordering=-name",[254],[380,556],{":zoom":382,"alt":557,"className":558,"src":559},"serversideup/php:8.5-fpm-apache",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-fpm-apache?label=serversideup%2Fphp%3A8.5-fpm-apache",[250,561,564],{"href":562,"rel":563},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-fpm-apache&page=1&ordering=-name",[254],[380,565],{":zoom":382,"alt":566,"className":567,"src":568},"serversideup/php:8.4-fpm-apache",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-fpm-apache?label=serversideup%2Fphp%3A8.4-fpm-apache",[250,570,573],{"href":571,"rel":572},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-fpm-apache&page=1&ordering=-name",[254],[380,574],{":zoom":382,"alt":575,"className":576,"src":577},"serversideup/php:8.3-fpm-apache",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-fpm-apache?label=serversideup%2Fphp%3A8.3-fpm-apache",[250,579,582],{"href":580,"rel":581},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-fpm-apache&page=1&ordering=-name",[254],[380,583],{":zoom":382,"alt":584,"className":585,"src":586},"serversideup/php:8.2-fpm-apache",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-fpm-apache?label=serversideup%2Fphp%3A8.2-fpm-apache",[351,588,589,591],{},[366,590,286],{},[366,592,593,374,595,374,604,374,613,374,622,631,633,374,635,374,644,374,653,374,662],{},[371,594,373],{},[250,596,599],{"href":597,"rel":598},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-fpm-nginx&page=1&ordering=-name",[254],[380,600],{":zoom":382,"alt":601,"className":602,"src":603},"serversideup/php:8.5-fpm-nginx",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-fpm-nginx?label=serversideup%2Fphp%3A8.5-fpm-nginx",[250,605,608],{"href":606,"rel":607},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-fpm-nginx&page=1&ordering=-name",[254],[380,609],{":zoom":382,"alt":610,"className":611,"src":612},"serversideup/php:8.4-fpm-nginx",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-fpm-nginx?label=serversideup%2Fphp%3A8.4-fpm-nginx",[250,614,617],{"href":615,"rel":616},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-fpm-nginx&page=1&ordering=-name",[254],[380,618],{":zoom":382,"alt":619,"className":620,"src":621},"serversideup/php:8.3-fpm-nginx",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-fpm-nginx?label=serversideup%2Fphp%3A8.3-fpm-nginx",[250,623,626],{"href":624,"rel":625},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-fpm-nginx&page=1&ordering=-name",[254],[380,627],{":zoom":382,"alt":628,"className":629,"src":630},"serversideup/php:8.2-fpm-nginx",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-fpm-nginx?label=serversideup%2Fphp%3A8.2-fpm-nginx",[416,632],{},[371,634,420],{},[250,636,639],{"href":637,"rel":638},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-fpm-nginx-alpine&page=1&ordering=-name",[254],[380,640],{":zoom":382,"alt":641,"className":642,"src":643},"serversideup/php:8.5-fpm-nginx-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-fpm-nginx-alpine?label=serversideup%2Fphp%3A8.5-fpm-nginx-alpine",[250,645,648],{"href":646,"rel":647},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-fpm-nginx-alpine&page=1&ordering=-name",[254],[380,649],{":zoom":382,"alt":650,"className":651,"src":652},"serversideup/php:8.4-fpm-nginx-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-fpm-nginx-alpine?label=serversideup%2Fphp%3A8.4-fpm-nginx-alpine",[250,654,657],{"href":655,"rel":656},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-fpm-nginx-alpine&page=1&ordering=-name",[254],[380,658],{":zoom":382,"alt":659,"className":660,"src":661},"serversideup/php:8.3-fpm-nginx-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-fpm-nginx-alpine?label=serversideup%2Fphp%3A8.3-fpm-nginx-alpine",[250,663,666],{"href":664,"rel":665},"https://hub.docker.com/r/serversideup/php/tags?name=8.2-fpm-nginx-alpine&page=1&ordering=-name",[254],[380,667],{":zoom":382,"alt":668,"className":669,"src":670},"serversideup/php:8.2-fpm-nginx-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.2-fpm-nginx-alpine?label=serversideup%2Fphp%3A8.2-fpm-nginx-alpine",[351,672,673,676],{},[366,674,675],{},"frankenphp",[366,677,678,374,680,374,689,374,698,374,707,709,374,711,713,714,719,720,374,722,374,731,374,740],{},[371,679,373],{},[250,681,684],{"href":682,"rel":683},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-frankenphp&page=1&ordering=-name",[254],[380,685],{":zoom":382,"alt":686,"className":687,"src":688},"serversideup/php:8.5-frankenphp",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-frankenphp?label=serversideup%2Fphp%3A8.5-frankenphp",[250,690,693],{"href":691,"rel":692},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-frankenphp&page=1&ordering=-name",[254],[380,694],{":zoom":382,"alt":695,"className":696,"src":697},"serversideup/php:8.4-frankenphp",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-frankenphp?label=serversideup%2Fphp%3A8.4-frankenphp",[250,699,702],{"href":700,"rel":701},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-frankenphp&page=1&ordering=-name",[254],[380,703],{":zoom":382,"alt":704,"className":705,"src":706},"serversideup/php:8.3-frankenphp",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-frankenphp?label=serversideup%2Fphp%3A8.3-frankenphp",[416,708],{},[371,710,420],{},[416,712],{}," ⚠️ Some users are experiencing ",[250,715,718],{"href":716,"rel":717,"target":255},"https://frankenphp.dev/docs/known-issues/",[254],"known performance issues"," with FrankenPHP on Alpine. Consider using the Debian version. ",[416,721],{},[250,723,726],{"href":724,"rel":725},"https://hub.docker.com/r/serversideup/php/tags?name=8.5-frankenphp-alpine&page=1&ordering=-name",[254],[380,727],{":zoom":382,"alt":728,"className":729,"src":730},"serversideup/php:8.5-frankenphp-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.5-frankenphp-alpine?label=serversideup%2Fphp%3A8.5-frankenphp-alpine",[250,732,735],{"href":733,"rel":734},"https://hub.docker.com/r/serversideup/php/tags?name=8.4-frankenphp-alpine&page=1&ordering=-name",[254],[380,736],{":zoom":382,"alt":737,"className":738,"src":739},"serversideup/php:8.4-frankenphp-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.4-frankenphp-alpine?label=serversideup%2Fphp%3A8.4-frankenphp-alpine",[250,741,744],{"href":742,"rel":743},"https://hub.docker.com/r/serversideup/php/tags?name=8.3-frankenphp-alpine&page=1&ordering=-name",[254],[380,745],{":zoom":382,"alt":746,"className":747,"src":748},"serversideup/php:8.3-frankenphp-alpine",[385,386],"https://img.shields.io/docker/image-size/serversideup/php/8.3-frankenphp-alpine?label=serversideup%2Fphp%3A8.3-frankenphp-alpine",[351,750,751,754],{},[366,752,753],{},"unit (deprecated)",[366,755,756,757],{},"NGINX stopped supporting NGINX Unit it has been removed from our project. ",[250,758,760],{"href":759},"/docs/image-variations/unit/","Learn more →",[242,762,764],{"id":763},"the-full-tag-schema","The full tag schema",[238,766,767],{},"Our tagging process is quite flexible, and it can become quite complex, but don't worry -- we've spent a ton of time applying sensible defaults to give you the best experience.",[238,769,770],{},"The full tag schema is as follows:",[289,772,776],{"className":773,"code":774,"language":775,"meta":10,"style":10},"language-jinja shiki shiki-themes github-dark","{{registry-url}}/serversideup/php:{{release-prefix}}-{{php-version}}-{{variation-name}}-{{operating-system}}-v{{github-release-version}}\n","jinja",[280,777,778],{"__ignoreMap":10},[297,779,780,784,788,792,795,798,801,803,806,808,811,813,815,817,820,822,825,827,829,831,834,836,839,841,843,845,848,850,853,855,858,860,863,865,867,869,871],{"class":299,"line":300},[297,781,783],{"class":782},"s9osk","{{",[297,785,787],{"class":786},"s95oV","registry",[297,789,791],{"class":790},"snl16","-",[297,793,794],{"class":786},"url",[297,796,797],{"class":782},"}}",[297,799,800],{"class":786},"/serversideup/php:",[297,802,783],{"class":782},[297,804,805],{"class":786},"release",[297,807,791],{"class":790},[297,809,810],{"class":786},"prefix",[297,812,797],{"class":782},[297,814,791],{"class":786},[297,816,783],{"class":782},[297,818,819],{"class":786},"php",[297,821,791],{"class":790},[297,823,824],{"class":786},"version",[297,826,797],{"class":782},[297,828,791],{"class":786},[297,830,783],{"class":782},[297,832,833],{"class":786},"variation",[297,835,791],{"class":790},[297,837,838],{"class":786},"name",[297,840,797],{"class":782},[297,842,791],{"class":786},[297,844,783],{"class":782},[297,846,847],{"class":786},"operating",[297,849,791],{"class":790},[297,851,852],{"class":786},"system",[297,854,797],{"class":782},[297,856,857],{"class":786},"-v",[297,859,783],{"class":782},[297,861,862],{"class":786},"github",[297,864,791],{"class":790},[297,866,805],{"class":786},[297,868,791],{"class":790},[297,870,824],{"class":786},[297,872,873],{"class":782},"}}\n",[238,875,876],{},"Here's what each part means:",[345,878,879,892],{},[348,880,881],{},[351,882,883,886,889],{},[354,884,885],{},"Option",[354,887,888],{},"Default",[354,890,891],{},"Other Options",[361,893,894,918,939,976,1012,1042],{},[351,895,896,904,912],{},[366,897,898,374,901,903],{},[280,899,900],{},"{{registry-url}}",[416,902],{},"Which registry to pull images from.",[366,905,906,374,909,911],{},[280,907,908],{},"''",[416,910],{},"(Docker Hub)",[366,913,914,917],{},[280,915,916],{},"ghcr.io"," (GitHub Packages)",[351,919,920,928,933],{},[366,921,922,374,925,927],{},[280,923,924],{},"{{release-prefix}}",[416,926],{},"The prefix of the release.",[366,929,930,932],{},[280,931,908],{}," (stable)",[366,934,935,938],{},[280,936,937],{},"beta"," (beta releases)",[351,940,941,949,956],{},[366,942,943,374,946,948],{},[280,944,945],{},"{{php-version}}",[416,947],{},"The version of PHP to use.",[366,950,951,952,955],{},"Latest stable PHP minor version (ie. ",[280,953,954],{},"8.5",")",[366,957,958,374,960,374,962,374,965,374,967,374,970,972,973,955],{},[280,959,282],{},[416,961],{},[280,963,964],{},"8.3",[416,966],{},[280,968,969],{},"8.2",[416,971],{}," (you can also specify the full version number, ie. ",[280,974,975],{},"8.4.1",[351,977,978,986,990],{},[366,979,980,374,983,985],{},[280,981,982],{},"{{variation-name}}",[416,984],{},"The name of the variation to use.",[366,987,988],{},[280,989,339],{},[366,991,992,374,994,374,996,374,998,374,1000,374,1002,374,1004,374,1006,374,1008,1011],{},[280,993,461],{},[416,995],{},[280,997,546],{},[416,999],{},[280,1001,286],{},[416,1003],{},[280,1005,675],{},[416,1007],{},[280,1009,1010],{},"unit"," (deprecated)",[351,1013,1014,1022,1027],{},[366,1015,1016,374,1019,1021],{},[280,1017,1018],{},"{{operating-system}}",[416,1020],{},"The operating system to use.",[366,1023,1024],{},[280,1025,1026],{},"debian",[366,1028,1029,374,1032,374,1034,374,1037,374,1039],{},[280,1030,1031],{},"alpine",[416,1033],{},[280,1035,1036],{},"bookworm",[416,1038],{},[280,1040,1041],{},"trixie",[351,1043,1044,1052,1055],{},[366,1045,1046,374,1049,1051],{},[280,1047,1048],{},"{{github-release-version}}",[416,1050],{},"The version of the GitHub release to use.",[366,1053,1054],{},"(latest stable release)",[366,1056,1057,1058,1063],{},"See our ",[250,1059,1062],{"href":1060,"rel":1061,"target":255},"https://github.com/serversideup/docker-php/releases",[254],"GitHub Releases"," for specific versions.",[1065,1066,1068],"warning",{"title":1067},"PHP 7.4, 8.0, and 8.1 are no longer built",[238,1069,1070,1071,1076],{},"These images are frozen at their last successful build. The tags stay pullable, but they receive no further security updates — for PHP or for the operating system underneath. Move to PHP 8.2 or newer. See ",[250,1072,1075],{"href":1073,"rel":1074},"https://github.com/serversideup/docker-php/blob/main/SECURITY.md#eol-versions-and-the-legacy-modernization-path",[254],"EOL versions and the legacy-modernization path"," for the full picture.",[1078,1079,1081],"note",{"title":1080},"Floating vs. version-pinned tags",[238,1082,1083,1084,1086,1087,1090,1091,1094,1095,1098,1099,1102,1103,1107,1108,1112],{},"Including ",[280,1085,1048],{}," (e.g. ",[280,1088,1089],{},"8.4-fpm-nginx-v4.3.5",") creates a ",[371,1092,1093],{},"version-pinned tag"," that is written once and never updated. Omitting it (e.g. ",[280,1096,1097],{},"8.4-fpm-nginx",") gives you a ",[371,1100,1101],{},"floating tag"," that we rebuild weekly with the latest security patches. The right choice depends on how you balance reproducibility against staying current — see ",[250,1104,1106],{"href":1105},"/docs/getting-started/upgrade-guide#how-our-releases-work","How our releases work"," and ",[250,1109,1111],{"href":1110},"/docs/getting-started/upgrade-guide#choosing-your-update-strategy","Choosing your update strategy"," in the upgrade guide.",[242,1114,317],{"id":1115},"php-version",[238,1117,1118],{},"There are many factors to consider when choosing the right PHP version. Best practices include:",[259,1120,1121,1124],{},[262,1122,1123],{},"Choose the latest PHP version (as your dependencies allow)",[262,1125,1126,1127],{},"Choose a PHP version that is receiving ",[250,1128,1131],{"href":1129,"rel":1130,"target":255},"https://www.php.net/supported-versions.php",[254],"active and security support by PHP",[238,1133,1134,1135,1140],{},"If you need help understanding what's new in each PHP version, check out ",[250,1136,1139],{"href":1137,"rel":1138,"target":255},"https://www.php.net/ChangeLog-8.php",[254],"the official PHP changelog",". This will give you a detailed overview of the changes and improvements in each version.",[242,1142,320],{"id":1143},"php-variation",[238,1145,1146],{},"Choose from several variations to suit your needs. Each variation is optimized for specific use cases.",[345,1148,1149,1159],{},[348,1150,1151],{},[351,1152,1153,1156],{},[354,1154,1155],{},"Variation",[354,1157,1158],{},"Description",[361,1160,1161,1170,1179,1188,1197],{},[351,1162,1163,1167],{},[366,1164,1165],{},[280,1166,339],{},[366,1168,1169],{},"Minimal image for running PHP from the command line only. No web server included.",[351,1171,1172,1176],{},[366,1173,1174],{},[280,1175,461],{},[366,1177,1178],{},"Runs PHP-FPM without a web server. Ideal for microservices architectures where you need a dedicated PHP backend.",[351,1180,1181,1185],{},[366,1182,1183],{},[280,1184,546],{},[366,1186,1187],{},"Combines PHP-FPM with Apache as a reverse proxy. Ideal for running WordPress with Docker.",[351,1189,1190,1194],{},[366,1191,1192],{},[280,1193,286],{},[366,1195,1196],{},"Combines PHP-FPM with NGINX as a reverse proxy. This is the traditional setup widely adopted for modern PHP applications, including Laravel.",[351,1198,1199,1203],{},[366,1200,1201],{},[280,1202,675],{},[366,1204,1205],{},"Modern application server built on Caddy that runs everything in a single process. Ideal for Laravel/Symfony applications with worker mode support, automatic HTTPS, and HTTP/2 and HTTP/3 protocols.",[1207,1208,62],"h3",{"id":339},[238,1210,1211],{},"The CLI variation is a minimal image designed for running PHP from the command line only. It does not include a web server. Use this variation when you need a disposable and repeatable method for easily running PHP scripts from your terminal.",[1213,1214],"u-button",{"ariaLabel":1215,"className":1216,"color":1224,"label":1215,"size":1225,"to":63,"trailing-icon":1226,"variant":1227},"Learn more about the CLI variation",[1217,1218,1219,1220,1221,1222,1223],"font-bold","ring","ring-inset","ring-blue-600","text-blue-600","hover:ring-blue-500","hover:text-blue-500","primary","md","i-lucide-arrow-right","outline",[1207,1229,66],{"id":461},[238,1231,1232],{},"The FPM (Fast Process Manager) variation runs PHP-FPM without a web server. This variation is ideal for microservices architectures where you need a dedicated PHP backend.",[238,1234,1235],{},"Use this variation when you already have a separate proxy or load balancer handling static content and routing PHP requests to your FPM container. This is commonly used in larger-scale deployments.",[1213,1237],{"ariaLabel":1238,"className":1239,"color":1224,"label":1238,"size":1225,"to":67,"trailing-icon":1226,"variant":1227},"Learn more about the FPM variation",[1217,1218,1219,1220,1221,1222,1223],[1207,1241,70],{"id":546},[238,1243,1244],{},"The FPM-Apache variation combines PHP-FPM with Apache as a reverse proxy. Apache serves static content directly and forwards PHP requests to PHP-FPM for processing.",[238,1246,1247,1248,1251],{},"This is an excellent choice for WordPress sites and applications that specifically require Apache features or ",[280,1249,1250],{},".htaccess"," support.",[1213,1253],{"ariaLabel":1254,"className":1255,"color":1224,"label":1254,"size":1225,"to":71,"trailing-icon":1226,"variant":1227},"Learn more about the FPM-Apache variation",[1217,1218,1219,1220,1221,1222,1223],[1207,1257,74],{"id":286},[238,1259,1260],{},"The FPM-NGINX variation combines PHP-FPM with NGINX as a reverse proxy. This is the traditional setup that has been widely adopted for modern PHP applications, including many Laravel deployments.",[238,1262,1263],{},"NGINX serves static files efficiently and proxies PHP requests to PHP-FPM, providing excellent performance and flexibility.",[1213,1265],{"ariaLabel":1266,"className":1267,"color":1224,"label":1266,"size":1225,"to":75,"trailing-icon":1226,"variant":1227},"Learn more about the FPM-NGINX variation",[1217,1218,1219,1220,1221,1222,1223],[1207,1269,78],{"id":675},[238,1271,1272],{},"The FrankenPHP variation is a modern application server built on top of the Caddy web server. It runs everything in a single process, eliminating the complexity of managing PHP-FPM and a separate web server.",[238,1274,1275],{},"Use this variation for Laravel or Symfony applications that can benefit from worker mode, automatic HTTPS, and modern protocols like HTTP/2 and HTTP/3. This is the recommended variation for new projects seeking cutting-edge performance.",[1213,1277],{"ariaLabel":1278,"className":1279,"color":1224,"label":1278,"size":1225,"to":79,"trailing-icon":1226,"variant":1227},"Learn more about the FrankenPHP variation",[1217,1218,1219,1220,1221,1222,1223],[1207,1281,1283],{"id":1282},"unit-deprecated","Unit (deprecated)",[1065,1285,1287],{"target":255,"to":1286},"https://github.com/nginx/unit?tab=readme-ov-file#nginx-unit",[238,1288,1289,1290],{},"In October 2025, NGINX stopped supporting NGINX Unit and archived the project. NGINX Unit has been removed from our project. ",[250,1291,1293],{"href":1286,"rel":1292},[254],"See the official announcement →",[242,1295,1297],{"id":1296},"operating-systems","Operating Systems",[238,1299,1300],{},"Choosing an operating system comes down to a few preferences, but ultimately you need to make sure your dependencies are available for the operating system you choose.",[345,1302,1303,1312],{},[348,1304,1305],{},[351,1306,1307,1310],{},[354,1308,1309],{},"Operating System",[354,1311,1158],{},[361,1313,1314,1324],{},[351,1315,1316,1321],{},[366,1317,1318,1320],{},[280,1319,1026],{}," (default)",[366,1322,1323],{},"Debian is a popular Linux distribution that is known for its stability and reliability. It is the default operating system for our images.",[351,1325,1326,1330],{},[366,1327,1328],{},[280,1329,1031],{},[366,1331,1332],{},"Alpine is a lightweight Linux distribution that is known for its small size and low resource usage.",[1065,1334,1336,1339,1346,1349,1366],{"title":1335},"Choose an OS release that's still supported",[238,1337,1338],{},"We publish images on an end-of-life operating system release only for as long as that distribution still serves a signed package repository. Once it stops, we can no longer build a patched image at all, so we stop rebuilding that base and its tags freeze where they are. That is what happened to Debian Bullseye and Alpine 3.16.",[238,1340,1341,1342,1345],{},"Be aware that EOL bases also ship EOL versions of other software like NGINX and OpenSSL — and no amount of ",[280,1343,1344],{},"apt upgrade"," will get you newer ones, because the distribution itself has stopped releasing fixes.",[238,1347,1348],{},"Before picking a base, confirm it's currently supported:",[1350,1351,1352,1359],"ul",{},[262,1353,1354],{},[250,1355,1358],{"href":1356,"rel":1357,"target":255},"https://endoflife.date/debian",[254],"Debian release lifecycle",[262,1360,1361],{},[250,1362,1365],{"href":1363,"rel":1364,"target":255},"https://endoflife.date/alpine-linux",[254],"Alpine Linux release lifecycle",[238,1367,1368,1369,1372],{},"If you must start on an EOL base, treat it as a stepping stone. See ",[250,1370,1075],{"href":1073,"rel":1371},[254]," for the recommended migration approach.",[1207,1374,1376],{"id":1375},"specific-versions","Specific versions",[1078,1378,1379],{},[238,1380,1381,1382,1107,1386,1389],{},"Not all operating systems are available for all image variations and PHP versions. Double check ",[250,1383,268],{"href":1384,"rel":1385,"target":255},"https://hub.docker.com/r/serversideup/php/tags",[254],[250,1387,275],{"href":273,"rel":1388,"target":255},[254]," for the most accurate list of available tags.",[238,1391,1392],{},"We also support specific versions of operating systems. So this means that you can choose versions like:",[1350,1394,1395,1399,1403,1408],{},[262,1396,1397],{},[280,1398,1036],{},[262,1400,1401],{},[280,1402,1041],{},[262,1404,1405],{},[280,1406,1407],{},"alpine3.23",[262,1409,1410],{},[280,1411,1412],{},"alpine3.24",[1414,1415,1416],"style",{},"html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .s9osk, html code.shiki .s9osk{--shiki-default:#FFAB70}html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .snl16, html code.shiki .snl16{--shiki-default:#F97583}",{"title":10,"searchDepth":1418,"depth":1418,"links":1419},2,[1420,1421,1422,1423,1424,1433],{"id":244,"depth":1418,"text":245},{"id":329,"depth":1418,"text":330},{"id":763,"depth":1418,"text":764},{"id":1115,"depth":1418,"text":317},{"id":1143,"depth":1418,"text":320,"children":1425},[1426,1428,1429,1430,1431,1432],{"id":339,"depth":1427,"text":62},3,{"id":461,"depth":1427,"text":66},{"id":546,"depth":1427,"text":70},{"id":286,"depth":1427,"text":74},{"id":675,"depth":1427,"text":78},{"id":1282,"depth":1427,"text":1283},{"id":1296,"depth":1418,"text":1297,"children":1434},[1435],{"id":1375,"depth":1427,"text":1376},"Learn how to choose the right image for your use case.",null,{},true,{"title":32,"description":1436},"iQ9gJ82JeA9H6pB8Y17x6MrwSndFOWoOjg04iZJWIs0",[1443,1445],{"title":28,"path":29,"stem":30,"description":1444,"children":-1},"Discover why thousands of developers trust serversideup/php for their production PHP applications.",{"title":36,"path":37,"stem":38,"description":1446,"children":-1},"Learn how to get started with serversideup/php Docker Images.",1789148861621]