/ documentation / docs / clients / desktop.md
desktop.md
 1  ---
 2  sidebar_position: 1
 3  ---
 4  
 5  # Desktop
 6  
 7  > Upload your knowledge base to Khoj and chat with your whole corpus
 8  
 9  ## Companion App
10  
11  Share your files, folders with Khoj using the app.
12  Khoj will keep these files in sync to provide contextual responses when you search or chat.
13  
14  ## Setup
15  :::info[Self Hosting]
16  If you are self-hosting the Khoj server, update the *Settings* page on the Khoj Desktop app to:
17  - Set the `Khoj URL` field to your Khoj server URL. By default, use `http://127.0.0.1:42110`.
18  - Do not set the `Khoj API Key` field if your Khoj server runs in anonymous mode. For example, `khoj --anonymous-mode`
19  :::
20  
21  
22  1. Install the [Khoj Desktop app](https://khoj.dev/downloads) for your OS
23  2. Generate an API key on the [Khoj Web App](https://app.khoj.dev/settings#clients)
24  3. Set your Khoj API Key on the *Settings* page of the Khoj Desktop app
25  4. [Optional] Add any files, folders you'd like Khoj to be aware of on the *Settings* page and Click *Save*.
26     These files and folders will be automatically kept in sync for you
27  
28  # Main App
29  
30  You can also install the Khoj application on your desktop as a progressive web app.
31  
32  1. Open the [Khoj Web App](https://app.khoj.dev) in Chrome.
33  2. Click on the install button in the address bar to install the app. You must be logged into your Chrome browser for this to work.
34  
35  ![progressive web app install icon](/img/pwa_install_desktop.png)
36  
37  Alternatively, you can also install using this route:
38  
39  1. Open the three-dot menu in the top right corner of the browser.
40  2. Go to 'Cast, Save, and Share' option.
41  3. Click on the "Open in Khoj" option.
42  
43  
44  ![progressive web app install route](/img/chrome_pwa_alt.png)