The cli-lite is a lightweight yet powerful command-line interface designed to make managing Balancer's infrastructure effortless, even for non-technical users. It enables you to:
- Quickly set up your instance – Scaffold your Balancer instance safely and efficiently, following best practices
- Automate infrastructure tasks – Seamlessly handle provisioning, scaling, and monitoring with minimal effort
- Securely access remote servers – Connect to your production environment via secure SSH connections on DigitalOcean
- And more!
With its intuitive syntax and comprehensive functionality, cli-lite streamlines complex operations, saves time, and ensures consistency in infrastructure management.
Navigate into cli-lite directory and start the program:
cd cli-lite && npm start- UNIX-like OS
- git
^v2.43.0 - Node.js
^v22.11.0 - npm
^v10.9.0 - Docker Engine
^v27.3.1 - Docker Compose
^v2.29.7
- 1 Shared CPU
- 1 GB Memory
- 25 GB Storage (Regular SSD)
- Setup a virtual machine (DigitalOcean)
- Install dependencies
- Install and configure
cli-lite - Setup Telegram (Optional)
up
Generates the environment assets and the compose.yaml file. Next, it prunes docker objects and restarts the daemon. Finally, it pulls the latest images from the registry, creates and starts the containers.
When executed, after generating the environment assets and the compose.yaml file, it runs:
docker system prune --all --force
systemctl restart docker
docker compose up --pull always --no-build --detachdown
Stops containers and removes containers, networks, volumes, and images created by up.
When executed, it runs:
docker compose downdown-up
Stops containers and removes containers, networks, volumes, and images created by up with:
docker compose downFinally, it generates the environment assets, the compose.yaml file and runs:
docker system prune --all --force
systemctl restart docker
docker compose up --pull always --no-build --detachrestart
Restarts all stopped and running services with:
docker compose restartlogs
Displays and subscribes to the log output from all services. If a variation is provided, it narrows down the logs to a specific service.
docker compose logs -f
# if a variation is provided
docker compose logs <variation> -fThe following variations are supported:
-
logs:postgresdisplays log output from the postgres service -
logs:apidisplays log output from the api service -
logs:guidisplays log output from the gui service -
logs:ctdisplays log output from the cloudflared service
prune
Removes all unused containers, networks and images (both dangling and unused) with:
docker system prune --all --forcerestart-daemon
Restarts the Docker service on the host machine with:
systemctl restart dockerview-config
Displays the data stored in the config.json file.
update-config-*
Updates the mutable properties in the config.json file one at a time. The following properties are mutable and can be changed by this action:
GUI_URLTELEGRAMEXCHANGE_*TUNNEL_TOKEN
update-cli
Downloads the latest version of cli-lite, installs its dependencies, and compiles it.
When executed, it runs:
git pull origin main
npm ci
npm run buildpsql
Starts the terminal-based front-end to PostgreSQL.
When executed, it runs:
docker compose exec -it postgres psql -U postgres# run the integration tests
npm run test:integration
# run the unit tests
npm run test:unit