Last update: May 23 2022

Let's install the LWT server. LWT uses a client-server architecture, which means it will run in your browser as a classical website. You can use any computer as the server, here are some ways to do it.

Run in a <a href="https://docs.docker.com/get-docker/" >Docker</a> container

It is the easiest way to install LWT, but the drawback is that it will use more or less 1 GB on your system.

If LWT is already downloaded, you only need to build the image by going into the project root folder and run using

docker-compose -f docker-compose.yml up -d

By default the server can be accessed on port 8010 (http://localhost:8010).

To remove the created containers run

docker-compose -f docker-compose.yml down

Otherwise, you can download the official image with

docker pull ghcr.io/hugofara/lwt

Windows 10

Possibility (a): Installation EasyPHP / LWT on Win10

Get Visual C++
1. Download "vcredist_x86.exe" from https://www.microsoft.com/en-us/download/details.aspx?id=30679
2. Choose the x86 version and download.
3. Run the installer "vcredist_x86.exe" in the Downloads folder.
Get EasyPHP
1. Go to https://www.easyphp.org/easyphp-devserver.php
2. Download "EasyPHP DevServer 17.0".
3. Open your Downloads folder and run the downloaded "EasyPHP-Devserver-17.0-setup.exe".
4. Install into "C:\Program Files (x86)\EasyPHP-Devserver-17".
Get the latest GitHub release, unzip it.

You can also try to download the latest stable version if you want the cutting-edge updates (that may include some bugs)
Install everything
1. Go into "C:\Program Files (x86)\EasyPHP-Devserver-17\eds-www\lwt".
2. Rename the file "connect_easyphp.inc.php" to "connect.inc.php". Sometimes the "php" extension is hidden, so be careful! You can display file extensions via the Windows Explorer settings and check it.
Start EasyPHP
1. Start EasyPHP via Desktop Icon (Devserver 17). In the Task Bar near the clock appears the EasyPHP app icon (it may be hidden!).
2. LWT can now be started. Right-Click on the EasyPHP icon in the taskbar, choose "Servers->Start/Restart all Servers", open a browser, and open http://127.0.0.1/lwt (please bookmark).
You may now install the LWT demo database, or define the first language you want to learn.

If you start up Windows, you must repeat Step 6a+b.

If you want to start EasyPHP every time you start Windows and avoid Step 6a, put an EasyPHP link into "C:\Users\‍(YourUID)\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup".

Now you must only do step 6b to start LWT.

Possibility (b): Installation XAMPP / LWT on Win10

Install XAMPP
1. Go to https://www.apachefriends.org/download.html
2. Download "XAMPP for Windows 7.3.30 (64 bit)" (or a higher PHP 7 version).
3. Open your Downloads folder and run the downloaded "xampp-windows-x64-xxx-installer.exe". Please install the components Apache, MySQL, PHP and phpMyAdmin into the folder C:\xampp.
Get the latest GitHub release, unzip it.

You can also try to download the latest stable version if you want the cutting-edge updates (that may include some bugs)
Now go into "C:\xampp\htdocs\lwt". Rename the file "connect_xampp.inc.php" to "connect.inc.php". Sometimes the "php" extension is hidden, so be careful! You can display file extensions via the Windows Explorer settings and check it.
Start LWT
1. Start the "XAMPP Control Panel" ("C:\xampp\xampp-control.exe") and start the two modules Apache and MySQL. Now the two module names should have a green background color.
2. LWT can now be started. Open a browser, and open http://localhost/lwt (please bookmark).
You may now install the LWT demo database, or define the first language you want to learn.

If you start up Windows, you must repeat Step 5a+b.

If you want to start "XAMPP Control Panel" every time you start Windows and to avoid Step 5a, put a "XAMPP Control Panel" link to "C:\xampp\xampp-control.exe" into "C:\Users\‍(YourUID)\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup". To autostart also the Apache and MySQL modules, please open "Config" within the XAMPP Control Panel and check the two checkboxes.

Hint: To fix a "XAMPP Control Panel" error "Xampp-control.ini Access is denied", please read and do the instructions in https://www.codermen.com/fix-xampp-server-error-xampp-control-ini-access-is-denied/

Now you must only do step 5b to start LWT.

macOS 10.10+

I no longer use Apple hardware. Therefore, I cannot test LWT itself and the following installation instructions on a Mac. Your help is very much appreciated.

Go to https://www.mamp.info/en/downloads/
Download "MAMP & MAMP PRO" (currently version 6.5).
Double-click on the downloaded installation package "MAMP_MAMP_PRO_xxx.pkg", accept the license, click on "Install for all users..." and on "Continue", on the next panel titled "Standard Install on Macintosh HD" click on "Customize", deselect "MAMP PRO", and click Install. You must enter your password. After this step MAMP is installed within a folder named "MAMP" in the Applications folder.
Get the latest GitHub release, unzip it.

You can also try to download the latest stable version if you want the cutting-edge updates (that may include some bugs)
Go to /Applications/MAMP/htdocs/lwt. Rename the file connect_mamp.inc.php to connect.inc.php.
Open MAMP.app in /Applications/MAMP. Accept the messages from the firewall. Apache and MySQL start automatically.
LWT can now be started in your web browser, go to: http://localhost:8888/lwt.
You may install the LWT demo database, or define the first language you want to learn.

If you want to use LWT again, just do step 8 and 9. The local webserver (MAMP) will be automatically stopped by quitting the MAMP application.

Linux

The following instruction were tested on Raspbian Stretch.

Open a terminal, type and execute the following commands:
1. Installation of LAMP:
  
  sudo apt-get update
  
  sudo apt-get install apache2 libapache2-mod-php php php-mbstring php-mysql mysql-server
2. Enable the extensions
  1. Go to your PHP folder (/etc/php/{{desired PHP version}}/{{PHP type}}/)
  2. Run sudo nano php.ini.
  3. Delete the ";" symbols before extension=mbstring and extension=mysqli.
3. Set MySQL root Password to "abcxyz"
  
```bash sudo mysql ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'abcxyz'; FLUSH privileges; QUIT; ```
1. Check MySQL access (if you see the MySQL prompt mysql> after the first command, everything is OK):
  
```bash mysql -u root -p abcxyz QUIT; ```
Get the latest GitHub release.

You can also try to download the latest stable version if you want the cutting-edge updates (that may include some bugs)
Unzip it.
Rename the file connect_xampp.inc.php in /[... Path to downloaded LWT ...]/lwt to connect.inc.php.
Edit this file connect.inc.php and set the MySQL password in line $passwd = "";. Change it to $passwd = "abcxyz";. Save the edited file connect.inc.php.
Open a Terminal window, type and execute the following commands:

sudo rm /var/www/html/index.html

sudo mv /[... Path to downloaded LWT ...]/lwt /var/www/html

sudo chmod -R 755 /var/www/html/lwt

sudo service apache2 restart

sudo service mysql restart
LWT can now be started in your web browser, go to: http://localhost/lwt.
You may install the LWT demo database, or define the first language you want to learn.

If you want to use LWT again, just do step 7.

Dependency management with Composer

If you have a technical knowledge of how Composer works for dependency management, you may consider using Composer. It is required for contributors only, but advanced users may want to use it as well. The official repository is at https://packagist.org/packages/hugofara/lwt.

Upgrade LWT

Backup the LWT directory. Backup your database (within LWT).
Get the latest GitHub release.

You can also try to download the latest stable version if you want the cutting-edge updates (that may include some bugs)
Unzip it.
Copy the following (if not already at its place and OK) from your LWT backup into the LWT directory: "connect.inc.php" and the whole "media" sub-directory (if you created one; contains your MP3 audio files).
Clear the web browser cache and open LWT as usual.