NetNIX — Features

// features

What's Inside NetNIX

A comprehensive virtual UNIX environment with everything from filesystems to networking.

[ /vfs ]

Virtual File System (VFS)

A full hierarchical filesystem following the Filesystem Hierarchy Standard. Everything persists in a single .zip archive stored in your AppData folder — portable, self-contained, and safe.

                        >
                        FHS Layout — /bin, /etc, /home, /usr, /var, /tmp and more
                    
                        >
                        UNIX Permissions — rwxr-xr-x / octal 755 notation per file
                    
                        >
                        Owner/Group — Full metadata tracking per file and directory
                    
                        >
                        Mount System — Mount external .zip archives at arbitrary paths
                    
                        >
                        Auto-Save — Configurable persistence on logout and write operations
                    
                        >
                        Single Archive — Entire system in one portable .zip file

[ nsh ]

Interactive Shell (nsh)

A command-line interface modelled after bash/sh with pipes, redirection, quoting, and command lookup.

nsh shell features

# Pipes — chain commands together user@netnix:~$ cat /etc/passwd | grep demo | wc -l 1 # Output redirection user@netnix:~$ ls /bin > commands.txt user@netnix:~$ echo "appended" >> commands.txt # Per-user startup scripts user@netnix:~$ cat ~/.nshrc echo "Welcome back, $USER!"

[ .cs ]

C# Scripting Engine

Write commands as plain-text .cs files — no project files needed. Scripts are compiled at runtime using Roslyn, cached in memory, and run inside a secure sandbox with access to the full NixApi.

hello.cs — example script

using System; using NetNIX.Scripting; public class Hello { static int Run(NixApi api, string[] args) { Console.WriteLine($"Hello, {api.Username}!"); Console.WriteLine($"You are in: {api.Cwd}"); // List files in current directory foreach (var item in api.ListDirectory(api.Cwd)) Console.WriteLine($" {item}"); return 0; } }

                        >
                        Roslyn Compilation — Runtime compile with automatic caching
                    
                        >
                        Rich NixApi — File I/O, user queries, networking, and more
                    
                        >
                        #include System — Code reuse across scripts via shared libraries
                    
                        >
                        Sandboxed — Scripts cannot touch the host by default

[ usr ]

Multi-User System

Root and unlimited regular user accounts with hashed password authentication, su/sudo privilege escalation, group-based access control, home directories with skeleton file templates, and full user/group management commands.

[ sec ]

Security Sandbox

Configurable compile-time scanning blocks dangerous namespaces (System.IO, System.Diagnostics, etc.) and tokens (File.Create, Process.Start). Per-script exceptions for trusted system tools. All scripts must use NixApi.

[ npak ]

Package Manager (npak)

A full package management system for distributing and installing software. Packages are .npak zip archives containing commands, libraries, and man pages with manifest-based metadata.

> Remote Repos — HTTP repository support at npak.controlfeed.org

                        >
                        AI Packages — kobold, nxai, koder available from the community
                    

                        >
                        Easy Publishing — Create manifest + zip your scripts to share
                    

                        >
                        Full Lifecycle — Install, remove, list, info, and remote get
                    

[ dmn ]

Daemon Services

Background script execution on dedicated threads with graceful shutdown via CancellationToken. Start, stop, list, and view logs. Built-in telnetd for multi-user remote Telnet access and httpd for serving files over HTTP. Dual logging to VFS and host filesystem with configurable per-daemon settings.

[ tel ]

Telnet Remote Access

Full multi-user Telnet server daemon (telnetd). Multiple simultaneous sessions on independent threads with login authentication, automatic terminal size detection via NAWS, configurable session limits and idle timeout, per-user session logging, and graceful disconnect handling.

[ net ]

Networking API

HTTP GET, POST, PUT, DELETE, PATCH, and HEAD exposed through api.Net. Form-encoded and JSON support, custom headers, status code inspection, and binary downloads. Powers curl, wget, fetch, and npak.

[ edt ]

Built-in Text Editor

Full-screen editor with line numbers, vertical and horizontal scrolling, auto-indent, cut/paste lines, code templates, search, and go-to-line. Works fully over Telnet with automatic terminal size detection.

[ cfg ]

Configuration System

Host-side config for boot behaviour plus in-VFS nxconfig command. Instance naming, boot banners, MOTD, auto-save control, and script-level persistent key/value settings.

[ man ]

80+ Manual Pages

Comprehensive documentation covering every command and concept. Browse with man, list with man --list, and search with man -k.

[ mnt ]

Mount System

Mount and unmount external .zip archives at arbitrary paths within the VFS. Create modular, composable environments by layering archives.