Merge branch 'master' into parallel-build-manager-workflow

Author: zhravan

CHANGELOG.md

@@ -1,3 +1,12 @@
+# [0.1.0-alpha.68](https://github.com/raghavyuva/nixopus/compare/v0.1.0-alpha.67...v0.1.0-alpha.68) (2025-11-24)
+
+
+### Bug Fixes
+
+* feature disabled error on signup ([#587](https://github.com/raghavyuva/nixopus/issues/587)) ([8af20ab](https://github.com/raghavyuva/nixopus/commit/8af20abf6c02706e6e726e63da4df7a1399645a3))
+
+
+
 # [0.1.0-alpha.67](https://github.com/raghavyuva/nixopus/compare/v0.1.0-alpha.66...v0.1.0-alpha.67) (2025-11-21)
 
 

README.md

@@ -69,7 +69,7 @@ You can customize your installation by providing the following optional paramete
 Example with optional parameters:
 
 ```bash
-nixopus install \
+sudo nixopus install \
   --api-domain nixopusapi.example.tld \
   --view-domain nixopus.example.tld \
   --verbose \
@@ -79,11 +79,14 @@ nixopus install \
 Example for custom ip setup:
 
 ```bash
-nixopus install \
+sudo nixopus install \
   --host-ip 10.0.0.154 \
   --verbose
 ```
 
+> [!NOTE]  
+> Running `nixopus install` requires root privileges (sudo) to install system dependencies like Docker. If you encounter permission errors, make sure to run the command with `sudo`.
+
 You can also install the CLI and run `nixopus install` with options in a single command, refer [installation documentation](https://docs.nixopus.com/install/#installation-options) for more details on options
 
 ## About the Name

cli/app/commands/install/deps.py

@@ -64,7 +64,12 @@ def install_dep(dep, package_manager, logger, dry_run=False):
             if dry_run:
                 logger.info(f"[DRY RUN] Would run: {install_command}")
                 return True
-            subprocess.check_call(install_command, shell=True)
+            result = subprocess.run(install_command, shell=True, capture_output=True, text=True)
+            if result.returncode != 0:
+                error_output = result.stderr.strip() or result.stdout.strip()
+                if error_output:
+                    logger.error(f"Installation command output: {error_output}")
+                raise subprocess.CalledProcessError(result.returncode, install_command, result.stdout, result.stderr)
             return True
         if package_manager == "apt":
             cmd = ["sudo", "apt-get", "install", "-y", package]
@@ -86,6 +91,15 @@ def install_dep(dep, package_manager, logger, dry_run=False):
             return True
         subprocess.check_call(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
         return True
+    except subprocess.CalledProcessError as e:
+        error_msg = str(e)
+        if "docker" in package.lower() and (e.returncode == 100 or "permission" in error_msg.lower()):
+            logger.error(failed_to_install.format(dep=package, error=f"Exit code {e.returncode}"))
+            logger.error("Docker installation requires root privileges.")
+            logger.error("Please run: sudo nixopus install")
+        else:
+            logger.error(failed_to_install.format(dep=package, error=e))
+        return False
     except Exception as e:
         logger.error(failed_to_install.format(dep=package, error=e))
         return False

cli/app/commands/version/version.py

@@ -1,4 +1,6 @@
-from importlib.metadata import version
+import sys
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
 
 from rich.console import Console
 from rich.panel import Panel
@@ -9,9 +11,27 @@ class VersionCommand:
     def __init__(self):
         self.console = Console()
 
+    def _get_version(self) -> str:
+        """Get version from package metadata or bundled version.txt"""
+        try:
+            return version("nixopus")
+        except PackageNotFoundError:
+            # Read from version.txt (works in both dev and PyInstaller bundle)
+            if getattr(sys, 'frozen', False) and hasattr(sys, '_MEIPASS'):
+                # Running from PyInstaller bundle
+                version_file = Path(sys._MEIPASS) / "version.txt"
+            else:
+                # Running from source
+                version_file = Path(__file__).parent.parent.parent.parent.parent / "version.txt"
+
+            if version_file.exists():
+                return version_file.read_text().strip().lstrip("v")
+
+            return "unknown"
+
     def run(self):
         """Display the version of the CLI"""
-        cli_version = version("nixopus")
+        cli_version = self._get_version()
 
         version_text = Text()
         version_text.append("Nixopus CLI", style="bold blue")

cli/app/main.py

@@ -1,6 +1,5 @@
 import os
 import time
-from importlib.metadata import version as get_version
 
 import typer
 from rich.console import Console
@@ -73,7 +72,8 @@ def main(
 
         console.print(panel)
 
-        cli_version = get_version("nixopus")
+        version_cmd = VersionCommand()
+        cli_version = version_cmd._get_version()
         version_text = Text()
         version_text.append("Version: ", style="bold white")
         version_text.append(f"v{cli_version}", style="green")

cli/build.sh

@@ -81,6 +81,7 @@ a = Analysis(
     datas=[
         ('../helpers/config.prod.yaml', 'helpers/'),
         ('../helpers/config.dev.yaml', 'helpers/'),
+        ('../version.txt', '.'),
     ],
     hiddenimports=[
         'app.commands.clone.command',

cli/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "nixopus"
-version = "0.1.26"
+version = "0.1.28"
 description = "A CLI for Nixopus"
 authors = ["Nixopus <[email protected]>"]
 readme = "README.md"

docs/cli/installation.md

@@ -190,11 +190,11 @@ Once the CLI is installed, you can use it to install Nixopus on your VPS:
 ::: code-group
 
 ```bash [Basic Installation]
-nixopus install
+sudo nixopus install
 ```
 
 ```bash [With Custom Domains]
-nixopus install \
+sudo nixopus install \
   --api-domain api.example.com \
   --view-domain app.example.com \
   --verbose
@@ -205,11 +205,15 @@ nixopus preflight
 ```
 
 ```bash [Install Dependencies Only]
-nixopus install deps
+sudo nixopus install deps
 ```
 
 :::
 
+::: warning Root Privileges Required
+The `nixopus install` command requires root privileges to install system dependencies like Docker. Always use `sudo` unless you're already running as root. If you encounter permission errors or "exit status 100", ensure you're using sudo.
+:::
+
 ::: tip Preflight Check
 Always run `nixopus preflight` before installation to verify your system meets all requirements. This can save time by catching issues early.
 :::

docs/install/index.md

@@ -61,9 +61,13 @@ curl -sSL https://install.nixopus.com | bash -s -- --skip-nixopus-install
 Once the CLI is installed, you can install Nixopus on your VPS:
 
 ```bash
-nixopus install
+sudo nixopus install
 ```
 
+::: warning Sudo Required
+Running `nixopus install` requires root privileges to install system dependencies (like Docker). Always use `sudo` when running the install command. If you encounter "exit status 100" or permission errors, ensure you're using sudo.
+:::
+
 ::: info CLI Verification
 Before proceeding, verify the CLI is working:
 ```bash
@@ -251,27 +255,37 @@ If you've already installed the CLI separately, you can run `nixopus install` di
 ::: code-group
 
 ```bash [With Domains]
-nixopus install \
+sudo nixopus install \
   --api-domain api.example.com \
   --view-domain example.com \
   --verbose
 ```
 
 ```bash [With IP]
-nixopus install \
+sudo nixopus install \
   --host-ip 192.168.1.100 \
   --verbose
 ```
 
 ```bash [Custom Ports]
-nixopus install \
+sudo nixopus install \
   --api-port 9000 \
   --view-port 9001 \
   --timeout 600
 ```
 
 :::
 
+::: tip Why Sudo?
+The `nixopus install` command needs root privileges to:
+
+- Install Docker and other system dependencies
+- Configure system-level services
+- Set up network configurations
+
+If you're already running as root user, you can omit `sudo`.
+:::
+
 ## Accessing Nixopus
 
 After successful installation, access your Nixopus instance:

package.json

@@ -1,15 +1,15 @@
 {
   "name": "nixopus",
-  "version": "0.1.0-alpha.67",
+  "version": "0.1.0-alpha.68",
   "description": "A modern container management platform",
   "private": false,
-  "cli-version": "0.1.26",
+  "cli-version": "0.1.27",
   "cli-packages": [
-    "nixopus-0.1.26-darwin-amd64.pkg",
-    "nixopus-0.1.26-darwin-arm64.pkg",
-    "nixopus_0.1.26_amd64.apk",
-    "nixopus_0.1.26_amd64.deb",
+    "nixopus-0.1.27-darwin-amd64.pkg",
+    "nixopus-0.1.27-darwin-arm64.pkg",
+    "nixopus-0.1.27-1.x86_64.rpm",
     "nixopus.tar",
-    "nixopus-0.1.26-1.x86_64.rpm"
+    "nixopus_0.1.27_amd64.deb",
+    "nixopus_0.1.27_amd64.apk"
   ]
 }