dPanel dPanel
Sign up
← All documentation
Command Line

dscript: Installation, Update, and Recovery Commands

Aug 26, 2026 · 3 views

dscript Command Reference

dscript is the primary CLI tool for installing, updating, and recovering dPanel servers. It bundles all the core commands needed to keep your control panel running smoothly.

Prerequisites

  • Operating System: Linux (Debian/Ubuntu, CentOS, Rocky, etc.)
  • Root or sudo access
  • Go 1.20+ (for building from source)
  • Network connectivity to the dPanel package repository

Installation

1. Install via the official installer script

curl -fsSL https://dpanel.io/install.sh | sudo bash

The script will:

  • Download the latest dscript binary
  • Verify its checksum
  • Place it in /usr/local/bin
  • Set executable permissions

2. Install from a package manager

# Debian/Ubuntu
sudo apt-get update
sudo apt-get install dpanel-dscript

# CentOS/RHEL
sudo yum install dpanel-dscript

3. Build from source

git clone https://github.com/dpanel/dscript.git
cd dscript
make build
sudo cp bin/dscript /usr/local/bin/

Updating dscript

The easiest way to keep dscript current is to run:

sudo dscript update

This command:

  • Checks the latest release on GitHub
  • Downloads the new binary
  • Replaces the old one atomically
  • Restarts any running dPanel services if necessary

If you prefer manual control, you can also use:

sudo dscript update --force

which bypasses the safety checks.

Recovery Commands

dscript provides a set of recovery utilities to restore a damaged or misconfigured dPanel installation.

1. Recover the configuration

sudo dscript recover config

This will:

  • Validate the current config file
  • Restore defaults if corruption is detected
  • Back up the old config to ~/.dpanel/config.bak

2. Restore from a backup

sudo dscript recover backup /path/to/backup.tar.gz

The backup file must be a tarball created with dscript backup.

3. Full system recovery

sudo dscript recover full

This performs:

  • Reinstalling all core packages
  • Restoring the default configuration
  • Rebuilding the database schema

Common Usage Patterns

  • Check version: dscript version
  • Show help: dscript --help
  • List available commands: dscript list
  • Get config: dscript config get <key>
  • Set config: dscript config set <key> <value>

Troubleshooting

Issue Fix
dscript not found Ensure /usr/local/bin is in your $PATH
Update fails Check network connectivity and run sudo dscript update --force
Recovery errors Verify backup integrity with tar -tf backup.tar.gz

Resources