Locally — Versola Docs
VersolaVersola/docs
0.5.0versola.kzGitHub

Locally

How to run Versola locally

Prerequisites: Docker must be installed and running on your system.

After installation, run the following commands:

versola doctor                    # Checks prerequisites (Docker, etc.)
versola bootstrap local <version> # Badge in website header

Once running, the admin console will open automatically. Follow these steps:

  1. Enter login and password:
    • Username: admin
    • Password: Admin1234!
  2. Enter OTP code:
    • Code: 123456
  3. Set a new password when prompted

To stop or remove Versola:

versola down       # Stop the stack
versola uninstall  # Remove everything: stack, images, local state

Apple Silicon Note: Docker images are currently built for AMD64 architecture only. Before running versola bootstrap, configure Docker to use AMD64 emulation:

export DOCKER_DEFAULT_PLATFORM=linux/amd64

Add this line to your shell profile (~/.zshrc or ~/.bashrc) to make it permanent. Performance will be slightly reduced due to Rosetta 2 translation, but functionality remains unaffected. Native ARM64 support is planned for a future release.