[{"data":1,"prerenderedAt":597},["ShallowReactive",2],{"navigation":3,"/docs/troubleshooting/common-issues":221,"/docs/troubleshooting/common-issues-surround":592},[4],{"title":5,"path":6,"stem":7,"children":8},"Docs","/docs","docs",[9,12,56,85,132,153,178,195,208],{"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],{"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,"icon":55,"defaultOpen":55,"path":180,"stem":181,"children":182,"page":55},"Customization","/docs/customizing-the-image","docs/6.customizing-the-image",[183,187,191],{"title":184,"path":185,"stem":186},"Changing php.ini settings","/docs/customizing-the-image/changing-common-php-settings","docs/6.customizing-the-image/1.changing-common-php-settings",{"title":188,"path":189,"stem":190},"Installing PHP extensions","/docs/customizing-the-image/installing-additional-php-extensions","docs/6.customizing-the-image/2.installing-additional-php-extensions",{"title":192,"path":193,"stem":194},"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":196,"path":197,"stem":198,"children":199,"page":55},"Troubleshooting","/docs/troubleshooting","docs/7.troubleshooting",[200,204],{"title":201,"path":202,"stem":203},"Common Issues","/docs/troubleshooting/common-issues","docs/7.troubleshooting/1.common-issues",{"title":205,"path":206,"stem":207},"Getting Help","/docs/troubleshooting/getting-help","docs/7.troubleshooting/2.getting-help",{"title":209,"path":210,"stem":211,"children":212,"page":55},"Reference","/docs/reference","docs/8.reference",[213,217],{"title":214,"path":215,"stem":216},"Environment Variable Specification","/docs/reference/environment-variable-specification","docs/8.reference/1.environment-variable-specification",{"title":218,"path":219,"stem":220},"Command Reference","/docs/reference/command-reference","docs/8.reference/2.command-reference",{"id":222,"title":201,"body":223,"description":587,"extension":361,"links":588,"meta":589,"navigation":289,"path":202,"redirect":588,"seo":590,"stem":203,"__hash__":591},"docs/docs/7.troubleshooting/1.common-issues.md",{"type":224,"value":225,"toc":576},"minimark",[226,231,239,243,246,251,259,262,340,346,349,364,368,372,380,384,387,393,447,452,517,524,528,531,559,563,572],[227,228,230],"h2",{"id":229},"overview","Overview",[232,233,234,235,238],"p",{},"This guide covers the most common issues users encounter and their solutions. If you don't find your issue here, check out our ",[236,237,205],"a",{"href":206}," guide for community and professional support options.",[227,240,242],{"id":241},"permission-issues","Permission Issues",[232,244,245],{},"Permission problems are one of the most common issues when working with Docker containers. They typically manifest as \"Permission denied\" errors when trying to write files.",[247,248,250],"h3",{"id":249},"understanding-the-problem","Understanding the Problem",[232,252,253,254,258],{},"By default, these images run as a non-root user (",[255,256,257],"code",{},"www-data",") for security. When your host machine uses a different user ID (UID) or group ID (GID), file permission conflicts can occur.",[232,260,261],{},"If your command is failing during build, then you likely need to switch to root to perform root tasks.",[263,264,269],"pre",{"className":265,"code":266,"filename":267,"language":268,"meta":10,"style":10},"language-dockerfile shiki shiki-themes github-dark","FROM serversideup/php:8.5-fpm-nginx\n\nUSER root\n\n# Install system packages\nRUN install-php-extensions intl bcmath\n\n# Switch back to www-data\nUSER www-data\n","Dockerfile","dockerfile",[255,270,271,284,291,300,305,312,321,326,332],{"__ignoreMap":10},[272,273,276,280],"span",{"class":274,"line":275},"line",1,[272,277,279],{"class":278},"snl16","FROM",[272,281,283],{"class":282},"s95oV"," serversideup/php:8.5-fpm-nginx\n",[272,285,287],{"class":274,"line":286},2,[272,288,290],{"emptyLinePlaceholder":289},true,"\n",[272,292,294,297],{"class":274,"line":293},3,[272,295,296],{"class":278},"USER",[272,298,299],{"class":282}," root\n",[272,301,303],{"class":274,"line":302},4,[272,304,290],{"emptyLinePlaceholder":289},[272,306,308],{"class":274,"line":307},5,[272,309,311],{"class":310},"sAwPA","# Install system packages\n",[272,313,315,318],{"class":274,"line":314},6,[272,316,317],{"class":278},"RUN",[272,319,320],{"class":282}," install-php-extensions intl bcmath\n",[272,322,324],{"class":274,"line":323},7,[272,325,290],{"emptyLinePlaceholder":289},[272,327,329],{"class":274,"line":328},8,[272,330,331],{"class":310},"# Switch back to www-data\n",[272,333,335,337],{"class":274,"line":334},9,[272,336,296],{"class":278},[272,338,339],{"class":282}," www-data\n",[341,342,343],"warning",{},[232,344,345],{},"Always switch back to a non-root user after completing privileged operations. Running containers as root is a security risk.",[232,347,348],{},"If your container is failing to run during runtime, then you may have a more advanced permissions issue. See our guide on understanding file permissions.",[350,351],"u-button",{"ariaLabel":171,"className":352,"color":360,"label":171,"size":361,"to":172,"trailing-icon":362,"variant":363},[353,354,355,356,357,358,359],"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",[227,365,367],{"id":366},"port-already-in-use","Port Already in Use",[247,369,371],{"id":370},"error-message","Error Message",[263,373,378],{"className":374,"code":376,"language":377},[375],"language-text","Error starting xyz service: listen tcp 0.0.0.0:80: bind: address already in use\n","text",[255,379,376],{"__ignoreMap":10},[247,381,383],{"id":382},"solution","Solution",[232,385,386],{},"Another process is using the port. Find and stop it, or use a different port:",[232,388,389],{},[390,391,392],"strong",{},"Find what's using the port:",[263,394,398],{"className":395,"code":396,"language":397,"meta":10,"style":10},"language-bash shiki shiki-themes github-dark","# On Linux/macOS\nsudo lsof -i :80\n\n# On Windows\nnetstat -ano | findstr :80\n","bash",[255,399,400,405,422,426,431],{"__ignoreMap":10},[272,401,402],{"class":274,"line":275},[272,403,404],{"class":310},"# On Linux/macOS\n",[272,406,407,411,415,419],{"class":274,"line":286},[272,408,410],{"class":409},"svObZ","sudo",[272,412,414],{"class":413},"sU2Wk"," lsof",[272,416,418],{"class":417},"sDLfK"," -i",[272,420,421],{"class":413}," :80\n",[272,423,424],{"class":274,"line":293},[272,425,290],{"emptyLinePlaceholder":289},[272,427,428],{"class":274,"line":302},[272,429,430],{"class":310},"# On Windows\n",[272,432,433,436,439,442,445],{"class":274,"line":307},[272,434,435],{"class":409},"netstat",[272,437,438],{"class":417}," -ano",[272,440,441],{"class":278}," |",[272,443,444],{"class":409}," findstr",[272,446,421],{"class":413},[232,448,449],{},[390,450,451],{},"If you must use a different port:",[263,453,459],{"className":454,"code":455,"filename":456,"highlights":457,"language":458,"meta":10,"style":10},"language-yaml shiki shiki-themes github-dark","services:\n  php:\n    image: serversideup/php:8.5-fpm-nginx\n    ports:\n      - \"8080:8080\"  # Use port 8080 instead\n      - \"8443:8443\"\n","compose.yml",[302,307,314],"yaml",[255,460,461,470,477,488,497,509],{"__ignoreMap":10},[272,462,463,467],{"class":274,"line":275},[272,464,466],{"class":465},"s4JwU","services",[272,468,469],{"class":282},":\n",[272,471,472,475],{"class":274,"line":286},[272,473,474],{"class":465},"  php",[272,476,469],{"class":282},[272,478,479,482,485],{"class":274,"line":293},[272,480,481],{"class":465},"    image",[272,483,484],{"class":282},": ",[272,486,487],{"class":413},"serversideup/php:8.5-fpm-nginx\n",[272,489,492,495],{"class":490,"line":302},[274,491],"highlight",[272,493,494],{"class":465},"    ports",[272,496,469],{"class":282},[272,498,500,503,506],{"class":499,"line":307},[274,491],[272,501,502],{"class":282},"      - ",[272,504,505],{"class":413},"\"8080:8080\"",[272,507,508],{"class":310},"  # Use port 8080 instead\n",[272,510,512,514],{"class":511,"line":314},[274,491],[272,513,502],{"class":282},[272,515,516],{"class":413},"\"8443:8443\"\n",[232,518,519,520,523],{},"Access your application at ",[255,521,522],{},"http://localhost:8080",".",[227,525,527],{"id":526},"getting-more-help","Getting More Help",[232,529,530],{},"If your issue isn't covered here:",[532,533,534,541,547,553],"ol",{},[535,536,537,540],"li",{},[390,538,539],{},"Search GitHub Discussions"," - Someone may have encountered the same problem",[535,542,543,546],{},[390,544,545],{},"Check the Documentation"," - Review guides specific to your setup",[535,548,549,552],{},[390,550,551],{},"Ask the Community"," - Post in GitHub Discussions or Discord",[535,554,555,558],{},[390,556,557],{},"Review Container Logs"," - Most issues show helpful error messages",[350,560],{"ariaLabel":561,"className":562,"color":360,"label":561,"size":361,"to":206,"trailing-icon":362,"variant":363},"View All Support Options",[353,354,355,356,357,358,359],[564,565,566],"tip",{},[232,567,568,569,571],{},"When asking for help, always include your image version, ",[255,570,456],{},", relevant error messages, and what you've already tried. This helps others help you faster!",[573,574,575],"style",{},"html pre.shiki code .snl16, html code.shiki .snl16{--shiki-default:#F97583}html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}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 .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}html pre.shiki code .s4JwU, html code.shiki .s4JwU{--shiki-default:#85E89D}",{"title":10,"searchDepth":286,"depth":286,"links":577},[578,579,582,586],{"id":229,"depth":286,"text":230},{"id":241,"depth":286,"text":242,"children":580},[581],{"id":249,"depth":293,"text":250},{"id":366,"depth":286,"text":367,"children":583},[584,585],{"id":370,"depth":293,"text":371},{"id":382,"depth":293,"text":383},{"id":526,"depth":286,"text":527},"Solutions to frequently encountered problems when using serversideup/php Docker images.",null,{},{"title":201,"description":587},"oFuouCiFyEEn-uZBX4W2aRfLkPi6Jj58ikyhV8UvlSs",[593,595],{"title":192,"path":193,"stem":194,"description":594,"children":-1},"Learn how to use our entrypoint.d directory to customize your container start up experience.",{"title":205,"path":206,"stem":207,"description":596,"children":-1},"Find the support you need - from free community resources to professional consulting services.",1776367056083]