---
title: Local Server
sidebar_position: 4
description: A step-by-step guide to start Jan Local Server.
---

<head>
    <title>Local Server - Jan Docs</title>
    <meta name="description" content="A step-by-step guide to start Jan Local Server, including setting up the server and making requests to the local server. Learn how to configure server settings and start using the built-in API server."/>
    <meta name="keywords" content="Jan AI, Jan, Local Server, API server, built-in server, start server, configure server settings, make requests"/>
    <meta property="og:title" content="Local Server - Jan Docs"/>
    <meta property="og:description" content="A step-by-step guide to start Jan Local Server, including setting up the server and making requests to the local server. Learn how to configure server settings and start using the built-in API server."/>
    <meta property="og:url" content="https://jan.ai/guides/local-server"/>
    <meta name="twitter:card" content="summary"/>
    <meta name="twitter:title" content="Local Server - Jan Docs"/>
    <meta name="twitter:description" content="A step-by-step guide to start Jan Local Server, including setting up the server and making requests to the local server. Learn how to configure server settings and start using the built-in API server."/>
</head>

Jan provides a built-in API server that can be used as a drop-in for OpenAI's API local replacement. This guide will walk you through on how to start the local server and use it to make request to the local server.

## Step 1: Set the Local Server
To start the local server, follow the steps below:
1. Navigate to the Jan main menu dashboard.
2. Click the corresponding icon on the bottom left side of your screen.
3. Select the model you want to use under the Model Settings screen to set the LLM for your local server.
4. Configure the server settings as follows:

| Feature                       | Description                                                                                                                                                   | Default Setting          |
|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
| Local Server Address          | By default, Jan is only accessible on the same computer it's running on, using the address 127.0.0.1. You can change this to 0.0.0.0 to let other devices on your local network access it. However, this is less secure than just allowing access from the same computer. | `localhost (127.0.0.1)`  |
| Port                          | Jan runs on port 1337 by default. The port can be changed to any other port number as needed.                                                                 | `1337`                   |
| Cross-Origin Resource Sharing (CORS) | Manages resource access from external domains. Enabled for security by default but can be disabled if needed.                                               | Enabled                  |
| Verbose Server Logs           | Provides extensive details about server activities as the local server runs, displayed at the center of the screen.                                          | Not specified (implied enabled) |

## Step 2: Start and Use the Built-in API Server
Once you have set the server settings, you can start the server by following the steps below:
1. Click the **Start Server** button on the top left of your screen.

:::note

When the server starts, you'll see a message like `Server listening at http://127.0.0.1:1337`, and the **Start Server** button will turn into a red **Stop Server** button.
:::

2. You will be redirected to the API reference server in your browser.
3. Select the available endpoints and try them out by executing the example request.
4. In this example, we will show you how it works using the `Chat` endpoint.
5. Click the **Try it out** button.
6. The Chat endpoint has the following `cURL request example` when running using a `tinyllama-1.1b` model local server:
```json
{
  "messages": [
    {
      "content": "You are a helpful assistant.",
      "role": "system"
    },
    {
      "content": "Hello!",
      "role": "user"
    }
  ],
  "model": "tinyllama-1.1b",
  "stream": true,
  "max_tokens": 2048,
  "stop": [
    "hello"
  ],
  "frequency_penalty": 0,
  "presence_penalty": 0,
  "temperature": 0.7,
  "top_p": 0.95
}
'
```
7. The endpoint returns the following `JSON response body`:
```json
{
  "choices": [
    {
      "finish_reason": null,
      "index": 0,
      "message": {
        "content": "Hello user. What can I help you with?",
        "role": "assistant"
      }
    }
  ],
  "created": 1700193928,
  "id": "ebwd2niJvJB1Q2Whyvkz",
  "model": "_",
  "object": "chat.completion",
  "system_fingerprint": "_",
  "usage": {
    "completion_tokens": 500,
    "prompt_tokens": 33,
    "total_tokens": 533
  }
}
```