Install Monolith on Windows 11/Mac/Linux

System preparation

• Request access to the GitHub organization: [https://github.com/wellnessliving/](https://github.com/wellnessliving/)

• Request access to the Install Team to get access to the required repositories:
  [https://github.com/orgs/wellnessliving/teams/install-team/members](https://github.com/orgs/wellnessliving/teams/install-team/members)

• Fill in your bot password:

  • Go to Content → Personnel: [https://dev.1024.info/studio/personnel-list.html](https://dev.1024.info/studio/personnel-list.html)

  • Find yourself in the list and click

  • Locate the Bot password field:

    • If it’s empty - click ! to generate the bot password, then save the form.

    • If it’s already filled - do nothing, the bot password is already set. :)

• Platform:
  • Windows
    • Enable WSL:

      • Open PowerShell as Administrator.

      • Run the command:

        Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

      • Restart your computer.

    • Change WSL version to v1:

      • Press Win + R, type cmd, and press Enter.

      • Run the command wsl --set-default-version 1

    • Install Ubuntu:

      • Open the Microsoft Store.

      • Find Ubuntu 22.04 LTS and click Install.

      • After installation, launch Ubuntu.

      • Wait for setup to complete.

      • Create a username and password.

  • Mac

    • Install Docker

    • Install brew from https://brew.sh/

    • Install required packages:
      
        brew install svn
        brew install jq
        brew install gnu-sed
      

    • Execute next command:
      
        PATH=“/opt/homebrew/opt/gnu-sed/libexec/gnubin:$PATH”
      
      Note: If you close terminal and open again, this command need execute again.

Preparing the installer for launch

• [Only for WSL]Run the command sudo su and enter your password.

• Open the repository [https://github.com/wellnessliving/koins-install](https://github.com/wellnessliving/koins-install) and download the required installer to your computer:

  • `install.sh` - installer for WSL

  • `install_docker.sh` - installer for macOS (Docker)

  • `debian_install.sh` - installer for Debian

• Copy the installer to the desired directory or run it from the current directory.

• Generate the install command using the form: https://output.jsbin.com/feguzef
  Note: If you install system not to WSL, change install.sh to another .sh script.

Explanation of fields:

• Bot login (your studio login):

  • Go to Content → Personnel: [https://dev.1024.info/studio/personnel-list.html](https://dev.1024.info/studio/personnel-list.html)

  • Find yourself and click

  • Copy the Login value into the generation form.

• Login for DB / Password for DB - credentials for your local database.

• Login for PRG - login for the Programmer’s Page (PRG).

• Checkout projects - whether to automatically checkout the project (`Yes` / `No`).

• Path to workspace - specify the Linux path that corresponds to your Windows workspace: /mnt/%LocalDisk%/ExampleFolder/SubFolder
  Example:

  • Linux path: /mnt/d/Workspace → Windows path: D:\Workspace

  • Maс path: /Users/{username}/Workspace, example: /Users/astro/Workspace

• Hostname for trunk/stable/production/studio - local domain names for each environment.

• Run the generated command in the Ubuntu console.
  Example: bash install.sh --bot-login login --checkout yes --trunk wl.tr --stable wl.st

• If everything is entered correctly, the installation will start.

• During installation:
  • When prompted “Would you like to continue [y/n]”, type y.

    

  • When prompted twice for “Write one time password from studio:”, copy the password from the top menu icon

    

    Note:

    • If you see this error, it means you don’t have access to the repository:

      

  • When asked “Are you sure you want to continue connecting (yes/no)?”, type yes.

    

• After the installation completes, you’ll see an informational message:

  

After installation, the following commands are available:

• sh ~/server.sh - start MySQL, Memcached, Apache, and DynamoDB.

• bash ~/dump.sh - create a database dump.

• bash ~/restore.sh - restore a database dump.

• service <service_name> <start|restart|stop> - for managing services.

Available services:

• mysql

• apache2

• memcached

• dynamodb

Available operations:

• start

• stop

• restart

Examples:

• service apache2 stop - stop Apache.

• service apache2 restart - restart Apache.

Last modification: 13.01.26 12:37