For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/guide/fnos.md.
  • English
  • 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 page for your version (for example v1.0.3b5) and download the .fpk package. Pick the package that matches your NAS CPU.

    PackageWhen to useDefault URLDetails
    Docker lite (Octop-fnos-docker-lite-<version>.fpk)Docker is installed, and you do not need a virtual desktop, OCR, or local embeddinghttp://<NAS-IP>:8088Pulls 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 Dockerhttp://<NAS-IP>:8088Pulls ghcr.io/tencentcloud/octop:<version>-full.
    Native amd64 (Octop-fnos-native-amd64-<version>.fpk)x86_64 NAS, no Dockerhttp://<NAS-IP>:8089Runs on FnOS with a Python runtime, headless Chromium, and remote desktop extras.
    Native arm64 (Octop-fnos-native-arm64-<version>.fpk)ARM64 NAS without Dockerhttp://<NAS-IP>:8089Same 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 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:
        docker exec -it octop octop user passwd <username> --password <new-password>
      • Native: SSH into the NAS and run:
        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 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.