# Create a local server configuration

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/go/2026.3/llms.txt).

> **TL;DR**
> `File | Settings | Build, Execution, Deployment | Deployment` for Windows and Linux
>
>
>
> `GoLand | Settings | Build, Execution, Deployment | Deployment` for macOS

A local server serves files from a local or mounted folder at a local URL. In a local server configuration, you develop your application in a GoLand project, then upload the project files to the server’s document root, the folder from which the server serves files.

To create a local server configuration in GoLand, [configure
the connection](#server-url) to the server. Then [map your project folder](#mapping) to its destination folder on the server and the corresponding URL path.

Procedure: 1. Specify the name, type, and visibility of a server configuration

1. Press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) to open settings and then select `Build, Execution, Deployment | Deployment`.

Alternatively, go to `Tools | Deployment | Configuration` in the main menu.

2. In the left pane, click Add ![Add item](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) and select Local or mounted folder in the popup menu.

3. In the Create new server dialog that opens, type the name of the server to create and click OK. The Create new server dialog closes and you return to the [Connection](deployment-connection-tab.html) tab of the [Deployment](settings-deployment.html) node.

4. From the list of servers, select the one you want to make default and click ![the Use as default button](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.setDefault.svg) Use as Default on the toolbar above the list of servers to [mark the server as default](configuring-synchronization-with-a-remote-host.html#default_server).

5. Keep Visible only for this project selected to use this configuration only in the current project. Clear it to make the configuration available to all projects.

> **Tip:**
> Project-specific configurations are stored in the `.idea` directory. Review these files before sharing them [through version control](version-control-integration.html). Server configurations available to all projects are stored in the IDE settings.

Procedure: 2. Set up connection to the server

In the `Connection` tab (`Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS))`| Build, Execution, Deployment | Deployment`), specify the server settings:

* Folder: the absolute path to an existing destination folder on your computer or a mounted drive. You need write access to upload files to this folder.

* Web server URL: the base URL used to open deployed files in a browser. Configure it only if a web server serves this folder.

Procedure: 3. Map project folder to a server folder and URL path

On the Mappings tab, specify the project folder to upload and its destination.

* Local path:  the absolute path to the local project folder. GoLand automatically fills out this field with the path to the currently opened project.

* Deployment path:  a folder under the server document root where GoLand will upload the contents of the project folder specified in the Local path field.

> **Tip:**
> Deployment path is relative to the Folder  path specified in the Connection tab.

If a folder with the specified name does not yet exist on the server, GoLand will create it when you trigger [project
upload](uploading-and-downloading-files.html#manually).

The easiest way is to map the entire project root folder to a folder under the server document root. The project folder structure in this case will be recreated on the server.

* Web path:  the URL path  configured for the folder specified in Deployment path. You can use a slash (`/`) to point to the root folder, or leave the field blank if the directory is not accessible from the web.

> **Tip:**
> Web path is relative to the Web server URL specified in the Connection tab.

> **Note:**
> Example:
>
>
>
> * Local path:`/Users/John.Smith/demo-project`
>
> * Deployment path: `/my-project`
>
> * Web path: `/my-project`

Now that you have the server configuration added, you can access the server's files and folders in the [Remote Host tool window](remote-host-tool-window.html). Go to `Tools | Deployment | Browse Remote Host` in the main menu, and in the tool window that opens, select the configured server from the drop-down list.

![Open the Remote Host tool window and select the server](https://resources.jetbrains.com/help/img/idea/2026.3/select_server_in_remote_host_tool_window.png)

## See also

