explaingit

ccebelenski/anas

Analysis updated 2026-05-18

2TypeScriptAudience · ops devopsComplexity · 4/5LicenseSetup · moderate

TLDR

ANAS adds TrueNAS-style ZFS storage, snapshot, replication, and SMB/NFS share management directly into the Proxmox VE web interface.

Mindmap

mindmap
  root((ANAS))
    What it does
      ZFS pool management
      Snapshots and replication
      SMB and NFS shares
      Live dashboard
    Tech stack
      TypeScript
      Node.js
      ZFS
      Samba
    Use cases
      Proxmox storage admin
      Cluster replication
      Network share hosting
    Audience
      Proxmox administrators
      Homelab operators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manage ZFS pools, datasets, and snapshots directly from the Proxmox VE web UI.

USE CASE 2

Set up local or remote replication jobs between ZFS pools, including to TrueNAS hosts.

USE CASE 3

Create and manage SMB and NFS shares without leaving the Proxmox interface.

What is it built with?

TypeScriptNode.jsZFSSambaNFS

How does it compare?

ccebelenski/anasadun-denton/chinvatagbara286/saint-cms
Stars222
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity4/54/52/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Proxmox VE node with Node.js 20+ and ZFS 2.2+, Samba/NFS packages needed only for those share types.

AGPL-3.0-or-later, you can use and modify it, but if you distribute it or run it as a network service, you must share your source changes under the same license.

In plain English

ANAS brings TrueNAS-style storage management to Proxmox VE, built directly into the existing Proxmox web interface rather than as a separate app you have to log into. It fills in the storage layer that Proxmox itself does not cover: ZFS pools, datasets, snapshots, replication, and SMB or NFS network shares, all presented as panels added into the same web UI Proxmox already uses for things like Ceph. The dashboard shows pool health, capacity, disk health across the whole fleet, running jobs, warnings, and live ZFS performance data such as cache usage and per-disk input and output with latency. From there you can create, import, export, or destroy ZFS pools, manage datasets with quotas and permissions, take and roll back snapshots, and set up replication jobs that copy data between pools locally or to a remote host over SSH, including other Proxmox cluster nodes or a TrueNAS box. Full SMB and NFS share management is included too, with an editor that keeps your existing configuration file's comments and formatting intact instead of overwriting it. The project describes its own design as guest-like: it treats the underlying system as the source of truth and avoids keeping any hidden state of its own, reading pool information straight from ZFS commands and share information from the real configuration files. It reuses Proxmox's certificates, login system, and job scheduling instead of building its own, and any destructive action needs an extra confirmation step before it runs. It runs on a Proxmox VE node with Node.js 20 or newer and ZFS 2.2 or newer, with Samba and NFS server packages needed only if you plan to use those specific share types. Installation is done by downloading a release, extracting it on the node, and running an installer script that checks the system first and can roll back cleanly if anything fails partway through. The project is still pre-1.0 and under active development, and it is licensed under the GNU Affero General Public License version 3 or later, the same license family Proxmox VE itself uses.

Copy-paste prompts

Prompt 1
Write a systemd timer that runs a zfs send/recv replication job on a schedule.
Prompt 2
How do I edit an smb.conf file programmatically while preserving existing comments and formatting?
Prompt 3
Design a transactional installer script that backs up, installs, health-checks, and rolls back on failure.
Prompt 4
Explain the tradeoffs of building a system tool as a 'guest' that reads existing config instead of storing its own state.

Frequently asked questions

What is anas?

ANAS adds TrueNAS-style ZFS storage, snapshot, replication, and SMB/NFS share management directly into the Proxmox VE web interface.

What language is anas written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, ZFS.

What license does anas use?

AGPL-3.0-or-later, you can use and modify it, but if you distribute it or run it as a network service, you must share your source changes under the same license.

How hard is anas to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is anas for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.