<commit_before>+++
title = "Desktop app"
description = "Run Urbit locally as a desktop application"
weight = 1
+++

### 1. Get Port

Port is a desktop GUI application that allows you to spin up, access, and manage your Urbit ships without any knowledge of the command line or Urbit binary.

{% tabs %}

{% tab label="MacOS" %}

To install **Port** on MacOS, simply download and open the `.dmg` file.

{% button label="Download Port" link="https://github.com/urbit/port/releases/latest/download/Port.dmg" color="bg-green-400 text-white" %}
{% /button %}

{% /tab %}

{% tab label="Linux" %}

We use `snap` so that **Port** can stay updated automatically. If you already have `snap` installed, simply run:

```sh
sudo snap install port
```

Or to install `snap` for your distribution, snapcraft provides [installation instructions](https://snapcraft.io/docs/installing-snapd).

{% /tab %}

{% tab label="Windows" %}

To install **Port** on Windows, simply download and open the `.exe` file.

{% button label="Download Port" link="https://github.com/urbit/port/releases/latest/download/PortSetup.exe" color="bg-green-400 text-white" %}
{% /button %}

{% /tab %}

{% /tabs %}

### 2. Boot a comet

A comet serves as a temporary identity for the network. It works just fine for checking out the network, but to download applications and get the full functionality of Urbit ID you’ll need a to get a planet.

Start Port and hit the **Start without an ID** button. It'll take a few minutes to spin up the new comet.

![](https://media.urbit.org/site/getting-started/Desktop-app-1.jpg)

### 3. Launch your ship

Once that's finished, click **Launch Ship into Urbit** and you'll be on the network.

![](https://media.urbit.org/site/getting-started/Desktop-app-2.jpg)

{% callout %}

**Want to combine the simplicity of Port with a permanent Urbit ID?**

If you already have a planet, first get your keyfile.
Start Port, click the **Boot a fresh ID** option. Give your ship a name, and in the **Shipname** field, enter your planet name, like `~sampel-palnet`. For the **Key File** field, browse to the keyfile, select it, and hit **Continue**.

Port will boot your Urbit in a few minutes!

For more information on getting a planet, see our [Getting an Urbit ID](/guides/getting-an-urbit-id) guide.

{% /callout %}

### Next steps

Learn how to [get around your urbit](/getting-started/getting-around).
<commit_msg>content: add warning for Port on windows (#1551)<commit_after>+++
title = "Desktop app"
description = "Run Urbit locally as a desktop application"
weight = 1
+++

### 1. Get Port

Port is a desktop GUI application that allows you to spin up, access, and manage your Urbit ships without any knowledge of the command line or Urbit binary.

{% tabs %}

{% tab label="MacOS" %}

To install **Port** on MacOS, simply download and open the `.dmg` file.

{% button label="Download Port" link="https://github.com/urbit/port/releases/latest/download/Port.dmg" color="bg-green-400 text-white" %}
{% /button %}

{% /tab %}

{% tab label="Linux" %}

We use `snap` so that **Port** can stay updated automatically. If you already have `snap` installed, simply run:

```sh
sudo snap install port
```

Or to install `snap` for your distribution, snapcraft provides [installation instructions](https://snapcraft.io/docs/installing-snapd).

{% /tab %}

{% tab label="Windows" %}

**WARNING:** Support for Windows is experimental. For the best experience, we recommend using a [cloud hosting provider](https://urbit.org/getting-started/hosted) rather than running Urbit locally.

To install **Port** on Windows, simply download and open the `.exe` file.

{% button label="Download Port" link="https://github.com/urbit/port/releases/latest/download/PortSetup.exe" color="bg-green-400 text-white" %}
{% /button %}

{% /tab %}

{% /tabs %}

### 2. Boot a comet

A comet serves as a temporary identity for the network. It works just fine for checking out the network, but to download applications and get the full functionality of Urbit ID you’ll need a to get a planet.

Start Port and hit the **Start without an ID** button. It'll take a few minutes to spin up the new comet.

![](https://media.urbit.org/site/getting-started/Desktop-app-1.jpg)

### 3. Launch your ship

Once that's finished, click **Launch Ship into Urbit** and you'll be on the network.

![](https://media.urbit.org/site/getting-started/Desktop-app-2.jpg)

{% callout %}

**Want to combine the simplicity of Port with a permanent Urbit ID?**

If you already have a planet, first get your keyfile.
Start Port, click the **Boot a fresh ID** option. Give your ship a name, and in the **Shipname** field, enter your planet name, like `~sampel-palnet`. For the **Key File** field, browse to the keyfile, select it, and hit **Continue**.

Port will boot your Urbit in a few minutes!

For more information on getting a planet, see our [Getting an Urbit ID](/guides/getting-an-urbit-id) guide.

{% /callout %}

### Next steps

Learn how to [get around your urbit](/getting-started/getting-around).

{'fraction_non_alphanumeric': 0.12871876239587465, 'fraction_numerical': 0.005553351844506148, 'mean_word_length': 4.182939362795478, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 11, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 14, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2744197', 'n_tokens_mistral': 1627, 'n_tokens_neox': 1468, 'n_words': 641}