If you encountered that ports 80 or 443 are not available, it’s recommended to terminate all processes using these ports and restart them. If it is not possible to stop the processes occupying these ports, you can modify the public port of the application proxy and re-run Bigcapital once more.
From .env there are two envirment variable for proxy port, change these ports to your custom port as shown in the below example.
To stop a previous version of Bigcapital running on these ports, run the following:Stop production containers: docker-compose --file docker-compose.prod.yml down
Stop development containers: docker-compose down
Kill all running containers: docker container kill $(docker ps -q)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bigcapital Docs","colors":{"primary":"#76A1FF","light":"#76A1FF","dark":"#000"},"logo":{"light":"https://mintcdn.com/bigcapital/WVY5ORu6xzXKmdxI/logo/light.svg?fit=max\u0026auto=format\u0026n=WVY5ORu6xzXKmdxI\u0026q=85\u0026s=bb81eb8e5af2fb5e066a47522688beb8","dark":"https://mintcdn.com/bigcapital/8aPCQyR4cPWP5gfj/logo/dark.svg?fit=max\u0026auto=format\u0026n=8aPCQyR4cPWP5gfj\u0026q=85\u0026s=78d9ccccea4e56cf20fd75142036be5d"},"favicon":"/favicon.png","appearance":{"default":"dark"},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Github","href":"https://github.com/bigcapitalhq/bigcapital"}},"footer":{"socials":{"x":"https://x.com/bigcapitalhq","github":"https://github.com/bigcapitalhq/bigcapital"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.com/invite/c8nPBJafeb"},{"anchor":"Blog","icon":"newspaper","href":"https://bigcapital.app/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bigcapital","hasAudioNarration":false,"actualSubdomain":"bigcapital","customDomains":["docs.bigcapital.app"],"gitSource":{"type":"github","owner":"bigcapitalhq","repo":"docs-v2","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a2201485cac5fa6292a51fe","collectionId":"367f51da-8d9c-420d-8dcb-198f7bf4470b","schemaVersion":"v2"},"entitlements":{},"buildId":"6a2201485cac5fa6292a51fe:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":702},{"language":"default","tag":"Reports","count":18},{"language":"default","tag":"Sale Invoices","count":17},{"language":"default","tag":"Sale Estimates","count":15},{"language":"default","tag":"Items","count":13},{"language":"default","tag":"Payments Received","count":12},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Accounts","count":11},{"language":"default","tag":"Sale Receipts","count":11},{"language":"default","tag":"Bills","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-logo{width:140px}"}],"page":{"pagePath":"deployment/troubleshooting","slug":"/deployment/troubleshooting","pageMetadata":{"title":"Troubleshooting","description":null,"href":"/deployment/troubleshooting","hidden":false},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`ports-unavailable`,children:`Ports unavailable`}),`\n`,_jsxs(_components.p,{children:[`If you encountered that ports 80 or 443 are not available, it’s recommended to terminate all processes using these ports and restart them. If it is not possible to stop the processes occupying these ports, `,_jsx(_components.strong,{children:`you can modify the public port of the application proxy and re-run Bigcapital once more`}),`.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`From `,_jsx(_components.code,{children:`.env`}),` there are two envirment variable for proxy port, change these ports to your custom port as shown in the below example.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# App Proxy`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`PUBLIC_PROXY_PORT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`8000`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`PUBLIC_PROXY_SSL_PORT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`443`})]}),`\n`]})})}),`\n`,_jsxs(_components.ol,{start:`2`,children:[`\n`,_jsxs(_components.li,{children:[`Run `,_jsx(_components.code,{children:`docker-compose up -d`})]}),`\n`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:`To stop a previous version of Bigcapital running on these ports, run the following:`}),_jsxs(_components.p,{children:[`Stop production containers: `,_jsx(_components.code,{children:`docker-compose --file docker-compose.prod.yml down`}),` `,_jsx(`br`,{}),`\nStop development containers: `,_jsx(_components.code,{children:`docker-compose down`}),` `,_jsx(`br`,{}),`\nKill all running containers: `,_jsx(_components.code,{children:`docker container kill $(docker ps -q)`})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshooting","description":null,"href":"/deployment/troubleshooting","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Ports unavailable","slug":"ports-unavailable","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bigcapital","siteName":"Bigcapital Docs","title":"Troubleshooting - Bigcapital Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-06T03:21:34.606Z","originalFileLocation":"deployment/troubleshooting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Bigcapital Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshooting - Bigcapital Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bigcapital Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bigcapital.app/deployment/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bigcapital.mintlify.app/_mintlify/api/og/v2?division=Deployments\u0026amp;title=Troubleshooting\u0026amp;theme=27be8ea02fd0c64f8a62df23\u0026amp;signature=8348a6b59c163d2f5ac4edc15bb78a22dcc94daec9a2d92d865bed46dc354b28\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshooting - Bigcapital Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bigcapital.mintlify.app/_mintlify/api/og/v2?division=Deployments\u0026amp;title=Troubleshooting\u0026amp;theme=27be8ea02fd0c64f8a62df23\u0026amp;signature=8348a6b59c163d2f5ac4edc15bb78a22dcc94daec9a2d92d865bed46dc354b28\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bigcapital/mM0OGJJEhXNBXmeE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bigcapital Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#76A1FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bigcapital.app/deployment/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/deployment/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bigcapital.app/#organization\",\"name\":\"Bigcapital Docs\",\"url\":\"https://docs.bigcapital.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bigcapital/WVY5ORu6xzXKmdxI/logo/light.svg?fit=max\u0026auto=format\u0026n=WVY5ORu6xzXKmdxI\u0026q=85\u0026s=bb81eb8e5af2fb5e066a47522688beb8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bigcapital.app#website\",\"name\":\"Bigcapital Docs\",\"url\":\"https://docs.bigcapital.app\",\"publisher\":{\"@id\":\"https://docs.bigcapital.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bigcapital.app/deployment/troubleshooting#webpage\",\"url\":\"https://docs.bigcapital.app/deployment/troubleshooting\",\"name\":\"Troubleshooting\",\"dateModified\":\"2026-03-06T03:21:34.606Z\",\"isPartOf\":{\"@id\":\"https://docs.bigcapital.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bigcapital.app/deployment/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bigcapital.app/deployment/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Deployments\",\"item\":\"https://docs.bigcapital.app/deployment/recommendation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Troubleshooting\",\"item\":\"https://docs.bigcapital.app/deployment/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bigcapital.app/deployment/troubleshooting#article\",\"headline\":\"Troubleshooting\",\"name\":\"Troubleshooting\",\"url\":\"https://docs.bigcapital.app/deployment/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bigcapital.app/deployment/troubleshooting#webpage\"},\"dateModified\":\"2026-03-06T03:21:34.606Z\",\"publisher\":{\"@id\":\"https://docs.bigcapital.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bigcapital.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bigcapital Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bigcapital Docs","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.com/invite/c8nPBJafeb"},{"anchor":"Blog","icon":"newspaper","href":"https://bigcapital.app/blog"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"Development","href":"/development"},{"title":"Architecture","href":"/architecture"}]},{"group":"Deployments","pages":[{"title":"System Recommendations","href":"/deployment/recommendation"},{"title":"Setup Script","href":"/deployment/setup-script"},{"title":"Docker","href":"/deployment/docker"},{"title":"Environment Variables","href":"/deployment/env_vars"},{"title":"Signup Restriction","href":"/deployment/signup_restriction"},{"title":"Plaid Setup","description":"This guide will walk you through configuring Plaid for your self-managed Bigcapital instance. You will learn how to obtain your Plaid credentials, set up the required environment variables, and configure webhooks. ","href":"/deployment/plaid_setup"},{"title":"Troubleshooting","href":"/deployment/troubleshooting"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Troubleshooting - Bigcapital Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}
