v1.0.1 · Stable release

Your cloud.
On FreeBSD.

An integrated Nextcloud installer for FreeBSD. Set up Nextcloud 35 by default, with its supporting services, through one guided installer.

Get the installer from the v1.0.1 release page.

Requires FreeBSD 15 or later (amd64)

Nextcloud on FreeBSD green daemon and cloud logo

FreeBSD foundations. Nextcloud services.

What is NextcloudOnFreeBSD?

One guided setup. Built around FreeBSD.

Think of it as an AIO-style setup experience for FreeBSD: ZFS storage, isolated jails, HTTPS, and optional office and Talk services. The installer handles their configuration and connections.

Nextcloud runs natively in a FreeBSD jail. Choose native ONLYOFFICE, or Euro-Office or Collabora CODE in a dedicated Linux VM—or use Nextcloud on its own.

This is an independent project—not official Nextcloud AIO or a FreeBSD port of it. It focuses on installation and integration; ongoing updates and backups remain under your control.

Compare with official Nextcloud AIO or explore the architecture.

Choose at installation

One cloud. Four office choices.

Choose the office server that suits you, or use Nextcloud on its own. Switching office backends after installation isn't supported yet.

Default · Native

ONLYOFFICE

Nextcloud and ONLYOFFICE run in separate Bastille VNET jails.

Two FreeBSD jails

Virtual machine

Euro-Office

A Nextcloud jail paired with Euro-Office in Docker on a dedicated Alpine Linux bhyve VM.

One FreeBSD jail + one VM

Virtual machine

Collabora CODE

A Nextcloud jail paired with Collabora Online CODE in Docker on a dedicated Alpine Linux bhyve VM.

One FreeBSD jail + one VM

No office runtime

Nextcloud only

Nextcloud without an integrated office server or office connector.

One FreeBSD jail

Client Push included. Talk if you need it.

Client Push helps Nextcloud desktop clients notice file changes sooner. Optional Talk adds calls and chat, with its own dedicated jail. It needs additional ports for calls.

Connect existing SFTP or HTTP/HTTPS storage with External files. It is off by default and works with any office choice, with or without Talk. Set up connections in Nextcloud after installation.

Compared with official Nextcloud AIO

Similar goal, different approach.

Both simplify setting up Nextcloud and its supporting services. Our installer focuses on FreeBSD installation and integration; AIO also manages ongoing updates and backups.

New deployments: NextcloudOnFreeBSD v1.0.1 and official Nextcloud AIO
AreaNextcloudOnFreeBSDOfficial Nextcloud AIO
FoundationFreeBSD 15+ (amd64), native jails, MariaDB and ZFS datasetsDocker Linux containers, PostgreSQL and Docker volumes
SetupTerminal wizard or JSON recipeMastercontainer with a web management interface
OfficeNative ONLYOFFICE; optional Euro-Office or Collabora CODE in a Linux VMOptional Nextcloud Office/Collabora or EuroOffice containers
Multiple instancesBuilt-in instance separation, with private networks and storageDocumented separate VMs or rootless Docker users, with distinct ports
UpdatesOperator-managed; no upgrade assistant for new deploymentsIntegrated updates, with optional automation
Backup and restoreOperator-managed; no integrated backup/restore for new deploymentsIntegrated BorgBackup, scheduling and restoration

Documentation-based comparison, reviewed November 18, 2026—not a hands-on AIO test. Retained datasets are not backups. Read the full comparison and official sources.

Your services, together

A familiar cloud. A FreeBSD foundation.

Actual views from our demonstration installation. Open a document from Files, work in ONLYOFFICE, and return to your cloud.

Nextcloud dashboard for the synthetic Release Demo account
Nextcloud: files, collaboration and your own workspace.
A saved demonstration document reopened in the integrated ONLYOFFICE editor
ONLYOFFICE: edit, save and reopen documents through Nextcloud.
Calendar app showing the demonstration calendar
Calendar, Contacts, Deck, Tasks and more: choose your apps during setup.
SnappyMail integrated into Nextcloud, showing empty mailbox sign-in fields
Choose SnappyMail or Nextcloud Mail. Connect your own mailbox afterward.

Before you start

What you’ll need.

Host & resources

  • Requires FreeBSD 15 or later (amd64).
  • Root access outside a jail and a healthy ZFS pool. Use a maintained RELEASE for production.
  • Host networking and firewall settings prepared using the host preparation guide.
  • Memory and storage for your selections; 16 GiB RAM or more is recommended for default selections.
  • Working bhyve hardware or nested virtualization for Euro-Office and Collabora CODE.
  • An interactive terminal, console recovery access and a second SSH session.

Tested on FreeBSD 15.1-RELEASE, 15.2-STABLE and 16-CURRENT.

A clean or dedicated FreeBSD host is not required. Install alongside existing jails on a suitably configured host; see the host preparation guide for networking, PF and resource-conflict requirements. The installer creates new deployments; it does not adopt or upgrade existing Nextcloud installations.

Networking & HTTPS

  • A fixed IPv4 address for your FreeBSD host—its LAN address if behind a router—plus working DNS and Internet access.
  • A public hostname for your Nextcloud server.
  • Let's Encrypt, supplied certificates, or an external HTTPS reverse proxy.
  • Port forwarding for HTTPS and, if selected, Talk. See the network setup instructions.

Choose your software versions.

Use the defaults—Nextcloud 35, PHP 8.5 and MariaDB 12.3—or choose other versions under Advanced software settings. Untested choices show a warning; installation may fail if the selected software is unavailable or incompatible.

See the installation guide for details.

Installation

Review. Approve. Install.

The wizard walks you through setup. Stay at your terminal to review settings and confirm network access.

  1. Get the installer

    Download and unpack the installer from the v1.0.1 release page. Keep its directory for Resume, recovery and removal.

  2. Choose your services

    Run this from the installer directory as root. The wizard covers storage, networking, HTTPS and applications, and asks before installing missing pkg/Python prerequisites.

    sh install.sh install
  3. Set up port forwarding

    Forward the selected web and Talk ports to the FreeBSD host, not its private jails or VM, using the values in your installation plan. An external HTTPS proxy changes the web route; follow the port-forwarding guide for the details. The installer does not configure your router.

  4. Review and install

    Check your settings and choose APPLY. When prompted, open a new SSH connection to check access, then enter KEEP before the timer expires.

Installation may update pkg and required dependencies. Keep your host updated and maintain your own backups afterward.

Prefer a settings file?

Copy the example for your office choice and edit its settings. The installer generates passwords; the recipe contains settings and certificate file paths.

sh install.sh plan /root/nextcloud-install.json
sh install.sh install --config /root/nextcloud-install.json

Run these commands from your installer directory. Planning needs Python 3.11+ and makes no changes to your host. Stay at the terminal during installation to answer prompts and confirm access.

Read the recipe guide.

Instance removal

Remove the services. Keep your data.

Use the original installer directory. Save and close editors, then disconnect clients. Normal removal keeps all application datasets, snapshots and office VM disks.

sh install.sh remove INSTANCE

Replace INSTANCE with your instance name and follow the confirmation prompts. Keep a second SSH connection available to check access.

Retained data is not a full backup or an automatic reinstall. Read the guide before removing an instance or permanently deleting its data.

Follow the uninstall guide.

Plan for ongoing care.

Thanks

Thank you to the maintainers, contributors, testers and documentation writers who make this possible.

Built with FreeBSD, Bastille, Nextcloud, ONLYOFFICE, vm-bhyve, Alpine Linux, Docker, Collabora and Euro-Office.

If you’d like to support my open-source work: GitHub Sponsors or Ko-fi. Thank you!