1"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[196],{3905:(e,t,n)=>{n.d(t,{Zo:()=>u,kt:()=>f});var o=n(7294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,o)}return n}function s(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,o,r=function(e,t){if(null==e)return{};var n,o,r={},a=Object.keys(e);for(o=0;o<a.length;o++)n=a[o],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o<a.length;o++)n=a[o],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var i=o.createContext({}),c=function(e){var t=o.useContext(i),n=t;return e&&(n="function"==typeof e?e(t):s(s({},t),e)),n},u=function(e){var t=c(e.components);return o.createElement(i.Provider,{value:t},e.children)},p="mdxType",d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.createElement(o.Fragment,{},t)}},h=o.forwardRef((function(e,t){var n=e.components,r=e.mdxType,a=e.originalType,i=e.parentName,u=l(e,["components","mdxType","originalType","parentName"]),p=c(n),h=r,f=p["".concat(i,".").concat(h)]||p[h]||d[h]||a;return n?o.createElement(f,s(s({ref:t},u),{},{components:n})):o.createElement(f,s({ref:t},u))}));function f(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var a=n.length,s=new Array(a);s[0]=h;var l={};for(var i in t)hasOwnProperty.call(t,i)&&(l[i]=t[i]);l.originalType=e,l[p]="string"==typeof e?e:r,s[1]=l;for(var c=2;c<a;c++)s[c]=n[c];return o.createElement.apply(null,s)}return o.createElement.apply(null,n)}h.displayName="MDXCreateElement"},2385:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>i,contentTitle:()=>s,default:()=>p,frontMatter:()=>a,metadata:()=>l,toc:()=>c});var o=n(7462),r=(n(7294),n(3905));const a={sidebar_position:5},s="Troubleshooting",l={unversionedId:"installation/troubleshooting",id:"installation/troubleshooting",title:"Troubleshooting",description:"While Hocus is in alpha, expect to encounter issues. As the web UI is still under development, error messages may not always be helpful. If you run into a problem, you should check the dev logs of the following services.",source:"@site/docs/02-installation/troubleshooting.md",sourceDirName:"02-installation",slug:"/installation/troubleshooting",permalink:"/docs/installation/troubleshooting",draft:!1,tags:[],version:"current",sidebarPosition:5,frontMatter:{sidebar_position:5},sidebar:"tutorialSidebar",previous:{title:"OIDC Authentication",permalink:"/docs/installation/oidc-auth"},next:{title:"Projects",permalink:"/docs/projects"}},i={},c=[{value:"Control Plane",id:"control-plane",level:3},{value:"Agent",id:"agent",level:3},{value:"SSH Connection Issues on MacOS",id:"ssh-connection-issues-on-macos",level:2}],u={toc:c};function p(e){let{components:t,...n}=e;return(0,r.kt)("wrapper",(0,o.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("h1",{id:"troubleshooting"},"Troubleshooting"),(0,r.kt)("p",null,"While Hocus is in alpha, expect to encounter issues. As the web UI is still under development, error messages may not always be helpful. If you run into a problem, you should check the dev logs of the following services."),(0,r.kt)("h3",{id:"control-plane"},"Control Plane"),(0,r.kt)("p",null,"If you experience issues in the UI, such as a 500 error, refer to the control plane logs."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"ops/bin/local-cmd.sh logs hocus-ui\n")),(0,r.kt)("h3",{id:"agent"},"Agent"),(0,r.kt)("p",null,"For problems related to prebuilds, workspaces, Git repository connections, or prebuilds stuck in the ",(0,r.kt)("strong",{parentName:"p"},"Pending")," state, refer to the agent logs."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"ops/bin/local-cmd.sh logs hocus-agent\n")),(0,r.kt)("h2",{id:"ssh-connection-issues-on-macos"},"SSH Connection Issues on MacOS"),(0,r.kt)("p",null,"If you are using MacOS and you are unable to connect to a workspace via SSH, you may
1need to add your SSH key to the SSH agent."),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"ssh-add --apple-use-keychain ~/.ssh/id_ed25519\n")))}p.isMDXComponent=!0}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.