Apploud CLI

A command-line tool for interacting with the Apploud container hosting service.

Installation

Global Installation (Recommended)

npm install -g apploud-cli

After installation, you can use the apploud command from anywhere on your system.

Local Installation

npm install apploud-cli

With local installation, you'll need to use the CLI through npx:

npx apploud-cli <command>

Configuration

By default, the CLI connects to the Apploud service at predefined URLs. You can override these with environment variables:

• APP_URL: The base URL of the Apploud API (default: http://10.88.226.106:8000)
• WS_URL: The WebSocket URL for real-time operations (default: ws://10.88.226.106:8001)

Example:

APP_URL=https://your-apploud-instance.com apploud login

Authentication

Before using most commands, you need to authenticate:

apploud login

This will open your browser for GitHub authentication.

Commands

Authentication

• login - Log in to the system and store authentication token
• logout - Log out and remove stored authentication token

Instance Management

• status - Check the status of the LXD server
• shell <instanceName> - Start a shell session with the specified instance
• ssh <instanceName> - Alias for shell command

File Transfer

• push <filePath> <instanceName> <destinationPath> - Push a file to the instance
  • -r, --recursive - Recursively push directories
• pull <instanceName> <filePath> <destinationPath> - Pull a file from the instance
  • -r, --recursive - Recursively pull directories

Debugging

If you encounter issues, you can run the debug utility:

apploud-cli-debug

For GitHub authentication issues:

apploud-cli-github-debug

License

MIT