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