> For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt.

# Use Octop on FnOS

Octop supports running directly on Feiniu (FnOS) NAS devices. You can manually install the official `.fpk` package from App Center, choosing either the Docker package or the native package. Once you complete the setup wizard, you can start chatting with your expert in minutes.

## Choose a package

Go to the [GitHub Releases](https://github.com/TencentCloud/Octop/releases) page for your version (for example `v1.0.3b5`) and download the `.fpk` package. Pick the package that matches your NAS CPU.

| Package                                                    | When to use                                                                         | Default URL            | Details                                                                           |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------- | --------------------------------------------------------------------------------- |
| **Docker lite** (`Octop-fnos-docker-lite-<version>.fpk`)   | Docker is installed, and you do not need a virtual desktop, OCR, or local embedding | `http://<NAS-IP>:8088` | Pulls `ghcr.io/tencentcloud/octop:<version>` (the lite tag) on first start.       |
| **Docker full** (`Octop-fnos-docker-<version>.fpk`)        | You want desktop, OCR, and local embedding inside Docker                            | `http://<NAS-IP>:8088` | Pulls `ghcr.io/tencentcloud/octop:<version>-full`.                                |
| **Native amd64** (`Octop-fnos-native-amd64-<version>.fpk`) | x86\_64 NAS, no Docker                                                              | `http://<NAS-IP>:8089` | Runs on FnOS with a Python runtime, headless Chromium, and remote desktop extras. |
| **Native arm64** (`Octop-fnos-native-arm64-<version>.fpk`) | ARM64 NAS without Docker                                                            | `http://<NAS-IP>:8089` | Same native contents as the amd64 package.                                        |


> **NOTE**
> 
> Releases use fixed version tags. The rolling `fnos-latest` tag is no longer provided. When upgrading, download the `.fpk` for the new release.
> 


## Install and get started


### Download the package

Open the [GitHub Releases](https://github.com/TencentCloud/Octop/releases) page, find your version, and download the **Docker** or **Native** `.fpk` package matching your NAS CPU.

### Install manually from App Center

In the FnOS desktop, open **App Center → Settings → Install app manually**, select the `.fpk` file, and confirm the installation.

### Complete the setup wizard

The wizard guides you through the initial setup:
- **Administrator username**: Enter your admin username.
- **Password**: Choose **Generate a random password** (recommended), or enter your own (must be at least 8 characters with both letters and digits).
- **Advanced settings**: Optionally set the log level and provide model API keys.

### Open the web UI

Click the **Octop AI assistant** desktop icon, or open the URL in your browser:
- Docker: `http://<NAS-IP>:8088`
- Native: `http://<NAS-IP>:8089`

### Sign in and change password

Sign in with the administrator credentials configured in the wizard.
- **View credentials**: Open the app **Settings** window in App Center to check the username and password. A backup copy is also saved in `octop-login.txt` in the data directory (and `/data/.octop/credential.txt` inside the container for Docker).
- **Change password**: After signing in, click **Change password** in the avatar menu.

### Configure a model and start chatting

Go to **Admin → Models**, enter your API key (such as Tencent Cloud Hunyuan, DeepSeek, or OpenAI), and enable it. Then open **Chat** and send your first message to the default `main` expert.


> **WARNING**
> 
> If your NAS is accessible from the internet or on a shared local network, do not keep the generated random password for long. Change it immediately after your first sign-in.
> 


## Management and maintenance

### View credentials and reset password

- **View initial credentials**: Open the Octop app **Settings** window in FnOS App Center.
- **Change password via CLI**:
  - **Docker**: Run in the NAS terminal:
    ```bash
    docker exec -it octop octop user passwd <username> --password <new-password>
    ```
  - **Native**: SSH into the NAS and run:
    ```bash
    octop user passwd <username> --password <new-password>
    ```
    If `octop` is not in your PATH, use `/usr/local/bin/octop` or `/var/apps/octop-native/bin/octop-cli`.
- **Forgot password**: See [Reset password](/en/guide/guides/reset-password.md) for the full recovery guide.

### Stop, restart, and upgrade

- **Service control**: Start, stop, or uninstall Octop directly in FnOS App Center.
- **Upgrades**: Download the new `.fpk` from GitHub Releases and install it manually in App Center. Your data directory and configuration are preserved automatically. The native edition can also upgrade from the web UI. See [Upgrade](/en/guide/guides/upgrade.md).


[**Quickstart**](/en/guide/quickstart.md)

Install on macOS, Linux, or Windows with a one-line installer.

[**Docker setup**](/en/guide/quickstart-docker.md)

Deploy using Docker run or Docker Compose.

[**LLM providers**](/en/guide/guides/llm-providers.md)

Configure API keys for Tencent Cloud, OpenAI, DeepSeek, and more.

[**IM channels**](/en/guide/guides/im-channels.md)

Connect your expert to Feishu, WeChat, DingTalk, or WeCom.
