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.
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.txtin the data directory (and/data/.octop/credential.txtinside 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.
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:
- Native: SSH into the NAS and run:
If
octopis not in your PATH, use/usr/local/bin/octopor/var/apps/octop-native/bin/octop-cli.
- Docker: Run in the NAS terminal:
- 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
.fpkfrom 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.

