> For the complete documentation index, see [llms.txt](https://docs.seawise.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.seawise.io/getting-started/quick-start.md).

# Quick Start

Get your first app online in about five minutes.

## Before you start

* A machine with Docker that can reach your apps (a home server, NAS, VPS, or your laptop)
* A Seawise.io account. [Sign in at seawise.io](https://seawise.io/login) with Google, GitHub, or your email. Signing in for the first time creates your account.

## Step 1: Run the client

Pick the command for your machine. You can also copy it from **Servers → Add Server** in the admin app.

**Linux**

```bash
docker run -d --name seawise \
  --restart unless-stopped \
  --network host \
  -v seawise-data:/config \
  ghcr.io/seawise-io/seawise-client:latest
```

**Docker Desktop (Mac / Windows)**

```bash
docker run -d --name seawise \
  --restart unless-stopped \
  -p 8082:8082 \
  -v seawise-data:/config \
  ghcr.io/seawise-io/seawise-client:latest
```

![The Add New Server dialog with the Docker command](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-658525a39a683e6b23a0852be40374736476fa80%2Fweb-add-server-dialog.png?alt=media)

Prefer Docker Compose or already run a Docker network for your apps? See [Configuration](/client/configuration.md).

## Step 2: Set a password

Open `http://your-server-ip:8082` in your browser. Create a password for the client's web UI (at least 8 characters) and click **Set Password & Continue**.

![Secure Your Server: set a password for the client](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-b51a5210c7fcd7b7eefd797f65f94e6a23575674%2Fclient-setup.png?alt=media)

> You have 5 minutes after the container starts to set the password. If the window passes, run `docker restart seawise` and try again.

## Step 3: Connect to your account

Click **Connect**. Give the server a name you'll recognize (it's filled in with the machine's hostname), then click **Connect** again.

![Connect to SeaWise: name your server](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-9acbfbaaae071ea39cc2b43f2532e15da2cdbac1%2Fclient-connect-modal.png?alt=media)

A new browser tab opens on seawise.io. Sign in if asked, check the server name and account, and click **Approve**.

![Approve this server?](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-4283f40e609d8f184ebd4860ca40d03ea23cbafe%2Fweb-connect-approve.png?alt=media)

The client finishes connecting on its own and its status changes to **Connected**. You can close the approval tab.

## Step 4: Add an app

Back in the client, fill in the **Add App** form:

* **App name**: what you'll see in Seawise.io, for example `Jellyfin`
* **Host**: where the client can reach the app (see the table below)
* **Port**: the port the app listens on, for example `8096`

Click **Add**.

![Adding Jellyfin in the client](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-3463b27ff43a879a0e92ba35342bb62d7b8e2389%2Fclient-add-app-filled.png?alt=media)

The app appears in the list with its address on `seawise.dev`.

![The client with three apps added](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-d9fd3cf9708e4ec3aacf752a32ce98914e339f9e%2Fclient-main-paired.png?alt=media)

**What to enter as the host:**

| How you started the client              | App runs on the same machine              | App runs on another device               |
| --------------------------------------- | ----------------------------------------- | ---------------------------------------- |
| Linux command (`--network host`)        | `localhost` or `127.0.0.1`                | The device's LAN IP, e.g. `192.168.1.50` |
| Docker Desktop command (`-p 8082:8082`) | `host.docker.internal`                    | The device's LAN IP                      |
| On a shared Docker network              | The app's container name, e.g. `jellyfin` | The device's LAN IP                      |

## Step 5: Open it from anywhere

Go to **Servers** in the admin app. Your server and its apps are listed there. A green dot means the app is online. Click a tile to open the app.

![The Servers page with three online apps](https://1178640790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN9a3N6oT8rUDCWLlcgkq%2Fuploads%2Fgit-blob-2c9dbacb346897d9a3da9d186ef8456724d88b35%2Fweb-servers.png?alt=media)

Apps are private by default: only you can open them until you share them.

## What's next

* [Share apps with a portal](/portals.md)
* [Give apps icons and nicknames](/apps/managing-apps.md)
* [Configure the client](/client/configuration.md) for Docker Compose, Unraid, Synology, and more