Skip to content
Ascend

Getting Started

Get up and running with Ascend on a docker. This guide will walk you through installation, configuration, and creating your first experiment.

Prerequisites

Section titled “Prerequisites”

Hardware Requirements

Section titled “Hardware Requirements”
ResourceMinimum
RAM8 GB
CPU4 cores
Disk Space20 GB free
OSmacOS 11+, Linux (Ubuntu 20.04+)

Software Requirements

Section titled “Software Requirements”

The following tools must be installed on your system:

ToolMinimum VersionInstallation
Dockerv20.10+Install Guide
curlv7.68+Pre-installed on most systems

Quick Start: One-Command Installation

Section titled “Quick Start: One-Command Installation”

Get Ascend running on a docker in under 10 minutes:

Terminal window
bash <(curl -fsSL https://raw.githubusercontent.com/dream-horizon-org/ascend/main/startup.sh)

What This Does

Section titled “What This Does”

The installation script automatically:

  1. ✅ Checks and installs prerequisites (Docker etc.)
  2. ✅ Clones the Ascend repository
  3. ✅ Deploys Ascend with all components
  4. ✅ Open http://localhost:9000 in browser

Expected Duration: 7-10 minutes (depending on internet speed and hardware)

Installation Output

Section titled “Installation Output”

You’ll see output similar to:

Terminal window
# bash startup.sh
  🚀 Installing Ascend platform to /Users/mac-user/.ascend...


  📦 Installing requirements...


  📁 Setting up installation directory...


  📥 Checking out repositories...


  🐳 Starting dependent services...
  Starting services for testlab...
  ✅ Started testlab services
  Starting services for flockr...
  ✅ Started flockr services
  Starting services for ascend-panel...
  ✅ Started ascend-panel services


  ✅ Ascend platform installed successfully in /Users/mac-user/.ascend
  🌐 Ascend started at http://localhost:9000

Now that Ascend is installed and configured, you can create your first experiment:

For a complete walkthrough, see:

Uninstallation

Section titled “Uninstallation”

To remove Ascend from your cluster:

Terminal window
# using the Uninstallation script
bash <(curl -fsSL https://raw.githubusercontent.com/dream-horizon-org/ascend/main/remove.sh)

Next Steps

Section titled “Next Steps”

Additional Resources

Section titled “Additional Resources”