Knowledge base in air-gapped networks

A wiki for an isolated network must install, search, authenticate and receive upgrades without any external service. This page covers what changes, which platforms fit, and what to ask a partner before work starts.

On this page

Why a knowledge base in an air-gapped network needs a different build

In an isolated network, the wiki is often where runbooks, policies and recovery procedures live, and a SaaS workspace is not an option because no external service can be reached. The build therefore has to work from media carried across the boundary, authenticate against directories inside the enclave and receive upgrades and content without a live connection. The differences show up in five places: how the install media is assembled, where extensions and themes come from, how search runs without outside services, how identity is wired to internal directories, and how upgrades and imported pages cross the gap. Each of these needs a decision before procurement, not after the first failed install.

On the platform short list, XWiki and BookStack are the self-contained candidates. XWiki ships as official Docker images under LGPL 2.1 with stable, LTS and intermediate LTS lines, so you can choose a line that matches your patch cadence and mirror the exact image tags you approve. BookStack is MIT-licensed and has a small footprint with few external dependencies, which simplifies the offline bundle. Outline needs more checking: its Business Source License 1.1 restricts certain commercial uses, and its cloud-first design means you should confirm every component it needs can be mirrored and run without outside calls before you rely on it. Confirm these points with the vendors and in a test enclave, not from this page alone.

Treat the first decision as a bill of materials for the enclave. List every container image, language package, font, extension and plugin the wiki needs, then confirm each one can be pulled, scanned and signed on the connected side and imported on the isolated side. Ask your partner to show the transfer log for each release, because the same record supports the software integrity checks that NERC CIP-013-2 describes for OT environments. If your enclave falls under that standard, or under similar supply chain expectations, the bill of materials becomes evidence, not just a build aid.

Which requirements an isolated wiki must meet and where they come from

This table maps each requirement an isolated wiki must meet to the build decision it creates and, where it applies, the regulation that asks for it. Read the source column first to see whether a rule binds your scenario, then use the build column to scope the work and the questions to put to a partner.

RequirementSource that drives itWhat it means for the build
Offline install and container imagesOperational need, plus NERC CIP-013-2 for verified software from vendorsMirror the XWiki or BookStack images, database images and base OS packages into an internal registry, and record hashes before transfer.
Extension and plugin management without internetNERC CIP-013-2 software integrity and authenticity for packages carried across the boundaryPre-approve each extension version, store signed copies internally and confirm the wiki can load them with outbound access blocked.
Local search without external servicesOperational need; no regulation in this scenario requires it specificallyUse the search engine bundled with the chosen wiki or an internal index. Confirm that no indexing service phones home and test queries with the network cut.
Internal identity via LDAP, SAML or OIDCHIPAA 164.312(e)(1) for access to ePHI over networks, where health data is in scopePoint the wiki at the internal directory or identity provider only. Confirm which SSO modules the chosen edition supports, since some sit in paid tiers.
Audit trail of page changesSEC 17a-4(b)(4) for retained business communications, and HIPAA 164.312(b) audit controls for ePHI systemsKeep page history, user activity and export logs on the internal store. Confirm retention periods with your records owner, because the wiki's history alone may not meet them.
Controlled transfer of upgrades and imported contentNERC CIP-013-2 for verifying integrity of software and patches carried across the boundaryDefine a one-way transfer procedure with hash checks, malware scanning and approval records. Imported Confluence or page exports are carried the same way.

Which regulations shape the wiki in isolated environments

A wiki in an isolated network becomes a regulated record as soon as it holds procedures, approvals or communications that a rule requires you to keep. Under SEC Rule 17a-4(b)(4), broker-dealers must preserve originals of communications received and copies of communications sent relating to the business, including inter-office communications, for not less than three years. Whether a wiki page or its revision history falls under that rule depends on how your firm uses the wiki. Confirm with your compliance lead whether pages that record decisions, trade-related instructions or supervisory communications are in scope, and if so, plan retention that keeps page history and attachments intact for the full period, including what happens to them during an offline upgrade or a restore from backup.

For healthcare organizations, the HIPAA Security Rule shapes two technical decisions. Section 164.312(b) requires audit controls that record and examine activity in systems containing ePHI, so the wiki's access and edit logs must be enabled, exported from the isolated network on a defined schedule and reviewed by someone who is accountable for them. Section 164.312(e)(1) requires protection against unauthorized access to ePHI transmitted over an electronic communications network, which applies to how the wiki is reached from clinical workstations and how content moves across the gap during imports and updates. Ask your auditor which of these safeguards apply to your wiki content and whether pages that mention patient information must be kept out of the general knowledge base altogether.

Utilities face a stricter path. NERC CIP-005-7 requires that all Interactive Remote Access to high and medium impact BES Cyber Systems pass through an Intermediate System, with encryption and multi-factor authentication, and that you have methods to detect and disable active vendor remote access sessions. A wiki hosted inside or near an electronic security perimeter must therefore be reached through the same controlled access points as other remote access, not through a direct browser connection from a corporate network. Decide early whether the wiki is treated as a BES Cyber System support asset, whether engineers can read runbooks from outside the perimeter, and which team owns the Intermediate System. These facts describe the obligations only. Your compliance lead and auditor must confirm which requirements apply to your environment.

Which open-source wikis fit an isolated network and why

Three wiki platforms cover most isolated-network needs, and each fails differently when the network has no route out. The differences sit in the license, the packaging for offline installs and the cost of extensions and identity features that the free edition may not include.

XWiki Standard

XWiki Standard is LGPL 2.1 licensed and ships official Docker images for MySQL, PostgreSQL and MariaDB, each running on Tomcat. Because the images are published for amd64 and arm64v8, you can mirror them into an internal registry and install without a route to Docker Hub. Three lines are published: stable at 18.8.0, long term support at 17.10.14 and the intermediate LTS at 18.4.7. Confirm which line your change process supports, and confirm that every extension you need is available as an artifact you can carry across the gap, since extension installs can otherwise reach public repositories.

XWiki Pro for identity features

XWiki Pro bundles the Active Directory and Azure Active Directory SSO applications and several connectors, which many regulated teams need for directory-backed access. It is a paid subscription from XWiki SAS, so the license cost, the support tier and the user count all sit in the quote. Ask whether the SSO and connector applications install from a local package in your environment, and whether a support plan covers offline upgrades of those applications. Confirm that the Pro features you need are available for on-premises deployment, since the pricing page states that cloud and on-premises prices match.

BookStack

BookStack is an MIT licensed wiki with a simple shelf, book and page structure that is easy to package for an offline host. Its MIT license has no use restrictions, which matters when a central security team must approve a license for every system in an enclosed network. The current release is v26.09.1. Check the offline path for PHP dependencies and the operating system packages it needs, and confirm how its authentication options (such as LDAP or SAML) connect to your internal directory without any external identity service.

Outline

Outline uses the Business Source License 1.1, and its additional use grant prohibits offering a commercial Document Service built on it. For an internal wiki that is usually not a barrier, but legal should confirm the grant before you deploy it for a partner or a regulated affiliate. Outline 1.11.0 is the current release. Verify whether its features, search and file storage depend on external cloud services, and test each one in an isolated lab before you commit, since a dependency on an outside service will break the design.

Paid air-gapped editions in collaboration tools

Vendors of chat and collaboration tools often reserve air-gapped deployment for paid editions. Mattermost lists it in Enterprise Advanced, Rocket.Chat excludes it from the free Starter plan, and Element offers an air-gapped Sovereign edition. Wiki vendors should be treated the same way until proven otherwise. Ask any wiki vendor in writing which edition includes offline installation, offline extension management and update packages, and whether support covers the disconnected case. Do not assume a free edition has the same offline features as the paid one.

Search and internal identity without external services

A wiki's search should read from an index that the wiki builds and stores inside your network. Confirm for each candidate whether its search engine is bundled with the application, runs as a separate service you host, or depends on a hosted API. Any step that sends queries or page text to an outside search service fails in an isolated network, and it can also leak content you intended to keep inside.

  • Index location: Confirm where the search index is stored and that it is rebuilt from local data without a network call.
  • External search APIs: Make sure no hosted search, analytics or AI indexing endpoint is configured, including optional plugins that are enabled by default.
  • Search engine dependencies: If the candidate uses a separate engine such as Elasticsearch or OpenSearch, confirm that its packages, container images and language data come from your offline repository.
  • Attachment and file indexing: Check whether text extraction from PDFs and Office files uses local libraries and whether it works without outbound access.
  • Index rebuild after import: Ask how the index is rebuilt after you load migrated or upgraded content, since that step is often where offline gaps appear.

Ask the candidate to demonstrate a full reindex and a search query on a host with its outbound connections blocked.

How an air-gapped wiki rollout runs, phase by phase

The sequence turns a wiki that cannot reach the internet into a tested, documented platform whose content, extensions and updates arrive through a controlled transfer process that the client owns.

  1. Classify content and define access before any build

    Your team and DeployOpen inventory the spaces, page types, attachments and sources the wiki must hold, then classify each by sensitivity and by who may read or edit it. The output is a content register and an access model that names the directory groups each space maps to. The step is done when the business owners of each space have signed off the register and the classification decides which network enclave hosts it.

  2. Approve the offline bill of materials

    DeployOpen lists every container image, package, extension, theme, font, language file and build dependency the platform needs, with its version and source. Your security and procurement teams review and approve the list, and they decide how each item is verified, including integrity and authenticity checks in line with your supply chain controls (for example, the control family in NERC CIP-013-2 if you operate in that sector). The step closes when the approved list is frozen and each item has a recorded owner.

  3. Build and verify the staging mirror

    On a connected staging network, DeployOpen assembles the approved artifacts, builds the images and records a cryptographic hash for each file, which the transfer manifest then carries. The staging environment is rebuilt from the manifest to confirm the output matches the list. The deliverable is a signed transfer bundle with a manifest, a hash report and a build record that the security team can check independently.

  4. Install inside the isolated network

    After the bundle crosses the boundary under your transfer procedure, DeployOpen loads the images into a private registry inside the isolated network and installs the wiki and its database, storage and search components from that registry only. Configuration points every component at internal addresses, and a network test confirms that no outbound connection is attempted. The step is complete when a clean install runs with the egress test passing and the install record is filed.

  5. Configure identity and offline search

    DeployOpen connects the wiki to your internal identity provider through the protocol your directory supports, maps directory groups to spaces and roles, and enables search using only components inside the enclave. Test accounts for each role confirm that page permissions hold, and search results are checked against known pages. The output is a tested access matrix and a search configuration record, both reviewed by the identity owner.

  6. Import content and test it end to end

    Approved content is imported from the transfer bundle, including page history, attachments and permissions where the source tool supports them. DeployOpen and your content owners check a sample of pages for completeness, broken links, attachment integrity and permission mapping, and log every gap. The step closes when the owners accept the test results and any unsupported items have a documented manual path.

  7. Cut over and run the first upgrade cycle

    You set a cutover date, freeze edits on the old source, run a final import and switch users to the isolated wiki with a rollback plan that is tested beforehand. The first real upgrade then runs through the same bundle, verification and install steps, which proves the transfer process before it is needed for an urgent fix. The output is a documented upgrade runbook, an operations owner and a record that the process worked from start to finish.

Integration points and deployment patterns for an isolated wiki

How do container images reach an isolated wiki cluster?

Images reach the wiki through an internal container registry mirror that your team fills from an approved transfer path. Kubernetes clusters can be built without internet access: kubeadm config images list and kubeadm config images pull fetch the control plane images ahead of time, and the --image-repository flag points kubeadm init at a private registry. The wiki's own images, such as XWiki or BookStack, need the same treatment, so every tag is copied, scanned and pinned by digest before it enters the enclave. Confirm which registry product is approved, who signs off on each import, and how image versions are recorded for later rollback.

How are wiki extensions and plugins supplied without internet access?

Extensions, themes and plugins must be downloaded outside the enclave, checked, and carried in as versioned packages. Many wikis install add-ons from public repositories at runtime, so the offline build has to be a fixed set of artifacts with recorded checksums. Confirm which extensions the business needs, their licenses, whether they run server-side code, and who approves a new package. For XWiki, the OIDC authenticator is maintained in the xwiki-contrib organization, so check its release and license before importing it. Plan for a documented update path that repeats the same review each time an extension changes.

How does an air-gapped wiki connect to an internal identity provider?

The wiki should authenticate against the identity provider already inside the enclave, usually through SAML, OIDC or LDAP. Because the identity service sits in the same network, no external sign-in service is needed, but the wiki must reach it on the correct internal hostnames and certificates. Confirm which protocol your identity platform offers, how the trusted certificate authority is distributed to the wiki server, how directory groups map to wiki roles, and what happens to access when the identity service is down. Also confirm whether break-glass local accounts are allowed and who controls them.

Where should the wiki database and backups live inside the enclave?

The database, attachments and backups should all stay inside the enclave, and backup copies should follow the same retention and transfer rules as the wiki itself. XWiki's official Docker images come in MySQL, PostgreSQL and MariaDB variants, so the database engine choice affects which backup tools and restore steps you need. Confirm the backup schedule, where backups are stored, whether a second enclave or site holds an encrypted copy, and how restores are tested. Ask who performs restores and whether the restore procedure has been rehearsed on a non-production copy.

What read-only copy of the wiki should on-call staff keep for recovery?

On-call and recovery staff need a read-only copy of critical runbooks and procedures that does not depend on the main wiki cluster. Typical options are a scheduled export to a static format, a separate read-only instance on different hardware, or printed copies kept at the site. Keep the copy small, versioned and reviewed, and make sure it can be opened without the wiki's database. Confirm which pages belong in the recovery set, how often the export is refreshed, who can access it during an outage, and how the team proves the copy is current. The same design also keeps runbooks readable when the identity service is unavailable.

How are wiki monitoring and audit logs exported from the enclave?

Logs from the wiki, its database, the identity integration and the host should be forwarded to a log platform inside the enclave, so that access and change events remain available for review. Audit controls matter for regulated workloads: the HIPAA Security Rule at 45 CFR 164.312(b) calls for audit controls that record and examine activity in systems containing ePHI. Confirm which events the wiki logs, such as page views, permission changes and login failures, how long they are kept, where they are stored, and who reviews them. Also confirm whether monitoring alerts reach staff through a path that works when the wiki is down.

Can DeployOpen implement these integration points for an isolated wiki?

DeployOpen plans, implements, integrates, hardens, backs up and documents self-hosted open-source platforms inside the client's own infrastructure, including air-gapped networks. For an isolated wiki, that work covers the registry and image path, extension packaging, identity integration, database and backup design, the recovery copy, and log export. Most engagements are fixed-scope, with scope, deliverables and timelines agreed in writing before work starts. DeployOpen does not publish a price list, so a quote follows from the written scope. Ask for a written list of integration points, the environment assumptions behind them, and the acceptance tests that will show each one works.

Evidence auditors ask for and which component produces it

This table maps the evidence an assessor typically asks for in an isolated wiki deployment to the component that generates it. Read each row as the source record you must keep, not as a finding. DeployOpen prepares and organizes this evidence, while independent auditors and assessors draw the conclusions.

EvidenceRegulation or control it supportsComponent that produces it
Page change history, revision logs and access logs from the wikiAudit controls over systems holding regulated information (HIPAA 45 CFR 164.312(b)); access control evidence in ISO 27001 and SOC 2 programsThe wiki's built-in page history plus the web server or reverse proxy access log, forwarded to a central log store inside the enclave
Transfer records and hash verification logs for packages and images crossing the air gapSoftware integrity and authenticity checks for vendor software and patches (NERC CIP-013-2 supply chain procurement)The staging process: transfer manifest, checksum or signature verification output and the import log kept on the controlled side of the boundary
Version inventory of the wiki core, database, extensions and container imagesChange management and patch tracking evidence for the operating platformA signed bill of materials or manifest generated at each import, plus the running version output from the wiki and its container runtime
Backup restore test records for pages, attachments and the databaseRecoverability of documented procedures and records (SEC Rule 17a-4 preservation, HIPAA documentation retention where applicable)Backup job logs from your backup tool and a dated restore test record written by the operator; the wiki does not produce this on its own
Identity group mapping export showing which directory groups map to which wiki rolesAccess authorization and least privilege evidence for internal policy and procedure contentThe directory export and the wiki's role or group mapping configuration, captured at each review cycle
Remote access and vendor session records for any maintenance work on the isolated networkRemote access controls for high and medium impact systems (NERC CIP-005-7 Interactive Remote Access)Session logs from the intermediate system or bastion host, not from the wiki itself

Questions to ask an implementation partner before an air-gapped wiki project

Start by asking how the offline bill of materials is built and signed. Ask the partner to list every container image, package, extension, search index, font and language pack that the wiki needs, including the database and Tomcat layers if you choose the XWiki Docker images, and to show how each artifact is pinned to a version and hash. Ask who signs the bundle, where the signing keys live and how you verify a signature inside the enclave. The same question applies to upgrades. Ask how a new release such as a later XWiki stable or LTS line is checked for integrity and authenticity before it crosses the gap, and how you will confirm which extensions are compatible with that version. Your own controls for software integrity under the supply chain requirements in NERC CIP-013-2 may apply here, so confirm with your assessor what evidence they expect.

Next, ask which features work fully offline. Search is the usual gap: confirm that the wiki's built-in search does not call an external indexing, translation, spell-check or analytics service, and ask for the partner's test results with outbound traffic blocked. Identity needs the same scrutiny. Ask how the wiki reaches your internal directory, whether through LDAP, SAML or OIDC, where the identity provider sits, and whether SSO features on the edition you plan to use, such as the Active Directory integrations listed for XWiki Pro, depend on a connector that makes outbound calls. Ask for a written list of every feature that needs an external service, because licensing or update checks can also reach outside your network.

Then cover staging and imports. If you are moving Confluence content, ask exactly what the migration tool supports. For XWiki's Confluence Migrator Pro, the vendor documentation says it keeps page history but not attachment history, and the trial is limited to 30 pages per migration, so confirm how the partner will handle attachment history and whether the source export is produced inside the enclave or on the external side. Ask how the staged export is scanned, how permissions and groups are mapped, and who approves the content before it is imported. Finally, ask about licensing and support: confirm the license of every component, whether any paid tier is needed for offline operation, and who answers the phone when the network is down. Ask for the escalation path, the on-site or cleared staff available, and how they will keep a copy of runbooks readable on the isolated side.

What buyers ask about cost, effort and running an offline wiki

How much does an air-gapped wiki cost and what drives the price?

The software license is often the smallest line item, because BookStack is MIT licensed and XWiki Standard is free open source. The cost comes from who does the work: consulting days, migration tooling, support subscriptions, hosting inside your network and staff time to run it. XWiki SAS lists consulting at 1200 EUR per day, which requires a Business or Enterprise support plan, and training at 1500 EUR per day. Confluence Migrator Pro is priced from 2000 EUR and has a trial limited to 30 pages per migration. Ask any partner for a quote that separates one-time work (design, installation, migration, hardening) from recurring work (support, upgrades, backups, monitoring), and state which license tier each line depends on.

How long does an offline wiki deployment take?

The duration depends on scope, not on the platform alone. The main variables are how many spaces and pages you are migrating, whether you need Confluence history and attachments, how many identity sources must be connected, and how many approval steps your change process requires inside a restricted network. Because transfer media, package review and maintenance windows all add time, ask for a written timeline tied to named milestones and to the systems the team must provide. Treat any duration given without a stated scope as a sales estimate, not a commitment.

What does our internal team need to provide for the project?

Three groups of people carry most of the work. Identity administrators provide the directory connection, group mappings and the single sign-on configuration, which is the step most likely to stall in an isolated network. Content owners decide which spaces are migrated, archived or rewritten, and they approve permissions for each space. Network staff own the transfer path across the gap, including media handling, checksum verification of every package and any firewall or proxy exceptions. Name a person in each group before the statement of work is signed, because delays usually come from unavailable approvers rather than from the software.

Can our own staff run an air-gapped wiki without a partner?

Yes, if you have people who can operate a Java or PHP web application, a relational database, a reverse proxy and a backup process, and who can carry out offline upgrades. BookStack and XWiki both publish installation paths that can be followed without internet access, but offline install, extension handling and search configuration still need hands-on testing in your environment. A partner is most useful for the parts that are hard to repeat: a tested transfer procedure, hardening, migration and documentation of the runbook. Whichever path you choose, confirm the vendor's current offline install steps with your own test environment before you rely on them.

Which paid tiers add air-gap support for wiki and collaboration tools?

Air-gapped deployment is often reserved for paid editions, so check the tier before you choose the platform. Mattermost lists air-gapped deployment in its Enterprise Advanced plan, Rocket.Chat excludes it from the free Starter plan, and Metabase offers it only on its Enterprise plan. Element Server Suite has a free AGPL Community edition, a Pro edition and a Sovereign edition for air-gapped deployments. For wikis, XWiki Pro and its support subscriptions add business applications, connectors and SAML or OIDC-related features, and XWiki SAS states that cloud and on-premises pricing is the same. Ask each vendor in writing which features and update channels your tier includes while disconnected.

How do we carry upgrades and extensions across the air gap?

Upgrades arrive as a verified package set that is downloaded outside the isolated network, scanned, checksummed and moved through an approved transfer path. The set should include the application release, the matching extension versions, container or package images and the database migration notes. Test every set on a staging copy that mirrors production before it enters the protected network, and keep the previous release available for rollback. Supply chain requirements such as NERC CIP-013-2 expect you to verify software integrity and authenticity for vendor software and patches, so record who approved each transfer. Confirm with the vendor whether a given release supports offline upgrades and how security fixes are published.

What does DeployOpen cover in an air-gapped wiki engagement?

DeployOpen plans, implements, customizes, integrates, hardens, backs up, upgrades, documents and supports self-hosted open-source platforms inside your own infrastructure, including air-gapped networks. Most engagements are fixed-scope, with scope, deliverables and timelines agreed in writing before work starts, and a quote follows from that written scope. Ongoing support, upgrades and continuous testing are available as retainers. DeployOpen prepares systems, controls and evidence for compliance assessments, but it does not issue audit reports or certifications, so independent auditors remain responsible for those.

How DeployOpen scopes, builds and supports an air-gapped wiki

DeployOpen plans, implements, hardens, documents and supports self-hosted open-source platforms inside the client's own air-gapped network. For a wiki, that means agreeing in writing which platform, extensions, identity connection and transfer process the isolated environment needs before any media crosses the boundary.

How we scope

  • Confirm which wiki fits the isolated network: BookStack, Outline or XWiki, based on structure and license terms
  • List every extension, theme and connector needed, and confirm each is available offline
  • Define the internal identity connection, such as directory and single sign-on, and who approves it
  • Agree how page history, attachments and imported content will be checked before entering the network
  • Record the scope in writing as a fixed-scope engagement with deliverables and timelines

How we build

  • Prepare container images, packages and database dependencies in a staging environment outside the boundary
  • Install the wiki and configure search so queries never call an external service
  • Connect internal identity and test role mapping, page permissions and access for administrators
  • Verify every package and image carried across the gap against recorded hashes and release sources
  • Test backups and restores inside the isolated network before go-live

How we hand over

  • Deliver installation, configuration and extension inventory documents with version numbers recorded
  • Document the transfer procedure for upgrades, security fixes and imported content across the gap
  • Provide runbooks for administrators, including recovery steps that do not depend on the wiki itself
  • Train named staff on editing, permission management and the approval steps for content transfers
  • Hand over evidence for access control and change records to support compliance readiness reviews

How we support

  • Offer ongoing support, upgrades and continuous testing as a retainer after go-live
  • Review each upstream release for security fixes and plan its transfer through the approved process
  • Retest identity integration and permissions after directory or platform changes
  • Keep documentation current with each change so the isolated environment stays supportable
  • Confirm support boundaries, response expectations and licensed vendor support in the written scope

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.