Skip to main content
Once ampup is installed, you can use it to manage multiple versions of ampd.

​
Install Commands

​
Install Latest Version

Install the latest version of ampd: 
ampup
or explicitly: 
ampup install
By default, the ampup installer automatically installs the latest version of ampd during initial setup.

​
Install Specific Version

Install a specific version by specifying the version tag: 
ampup install v0.1.0

​
Version Management

​
List Installed Versions

View all installed versions of ampd: 
ampup list

​
Switch Between Versions

Switch to a different installed version: 
ampup use v0.1.0
This updates the ~/.amp/bin/ampd symlink to point to the specified version.

​
Uninstall a Version

Remove a specific version: 
ampup uninstall v0.1.0

​
Building from Source

ampup provides powerful options for building ampd from source.

​
Build from Main Branch

Build from the default repository’s main branch: 
ampup build

​
Build from Specific Branch

Build from a specific branch: 
ampup build --branch main

​
Build from Specific Commit

Build from a specific commit hash: 
ampup build --commit abc123

​
Build from Pull Request

Build from a GitHub Pull Request: 
ampup build --pr 123

​
Build from Local Repository

Build from a local repository path: 
ampup build --path /path/to/amp

​
Build from Custom Repository

Build from a forked or custom repository: 
ampup build --repo username/fork

​
Combine Build Options

You can combine multiple options: 
# Custom repo + branch
ampup build --repo username/fork --branch develop

​
Custom Version Name

Build with a custom version name: 
ampup build --path . --name my-custom-build

​
Specify Build Jobs

Build with a specific number of parallel jobs: 
ampup build --branch main --jobs 8

​
Build Options Summary

OptionDescription
--branch <BRANCH>Build from a specific branch
--commit <HASH>Build from a specific commit
--pr <NUMBER>Build from a GitHub Pull Request
--path <PATH>Build from a local repository
--repo <OWNER/REPO>Build from a custom repository
--name <NAME>Use a custom version name
--jobs <N>Number of parallel build jobs

​
Update ampup

Update ampup itself to the latest version: 
ampup update

​
Build Requirements

When building from source, you need:
  • Rust toolchain (install from https://rustup.rs)
  • Git
  • Build dependencies (see main project documentation)

​
Environment Variables

​
GITHUB_TOKEN

For private repository access: 
export GITHUB_TOKEN="your-token-here"
ampup build --repo owner/private-repo

​
AMP_REPO

Override the default repository: 
export AMP_REPO="username/fork"
ampup install

​
AMP_DIR

Override the installation directory: 
export AMP_DIR="/custom/path"
ampup install

​
Examples

​
Install and Switch Between Versions

# Install multiple versions
ampup install v0.1.0
ampup install v0.2.0

# List installed versions
ampup list

# Switch to v0.1.0
ampup use v0.1.0

# Verify active version
ampd --version

# Switch back to v0.2.0
ampup use v0.2.0

​
Test a Pull Request

# Build and test a PR
ampup build --pr 456 --name test-pr-456

# Switch to the built version
ampup use test-pr-456

# Test the changes
ampd --help

# Switch back to stable
ampup use v0.2.0

​
Development Workflow

# Build from local development repository
ampup build --path ~/projects/amp --name dev-build

# Use the development build
ampup use dev-build

# After testing, switch back
ampup use v0.2.0

Build docs developers (and LLMs) love

Get started for freeTalk to us