LenaSYS-dockerenv

Log | Files | Refs | README | LICENSE

README.md (1959B)


      1 # LenaSYS-docker
      2 Docker environment for hosting [LenaSYS](https://github.com/HGustavs/LenaSYS). This project automatically clones the latest version of LenaSYS and hosts it with the proper settings. 
      3 
      4 ## prerequisites
      5 
      6 In order to use this project you need to install:
      7  - [Git](https://github.com/git-guides/install-git)
      8  - [Docker](https://docs.docker.com/get-docker/)
      9 
     10 ## Installation
     11 
     12 1. First clone the project to a location of your liking:
     13 
     14     ``` git clone https://github.com/a22willi/LenaSYS-dockerenv.git ```
     15 
     16 2. Start the docker containers 
     17 
     18     Navigate to the *LenaSYS-dockerenv* folder, and run the command:
     19 
     20     ``` docker compose up -d ```
     21 
     22 3. Run the install script
     23 
     24     Navigate to [LenaSYS/install/install.php](http://localhost/LenaSYS/install/install.php) and run the installer. The first page should have its information preselected. When asked for a database root password, simply write `password`.
     25 
     26 4. Running Linux?
     27 
     28     Since the LenaSYS repository needs to remain under the ownership of the `www-data` user, you may lack permission to modify the files. To gain access, run the command `chmod 777 -R LenaSYS`. This will allow any user to modify the files. However, Git will see modified file permissions as changes. To prevent this, run `git config core.fileMode false`.
     29 
     30 ## Current limitations
     31 
     32 Due to current limitations with the installer, the MySQL-user is limited to connect from the same hostname as previoulsy specified. This does not work for docker installations such as this one. See [issue-#14281](https://github.com/HGustavs/LenaSYS/issues/14281).
     33 
     34 To circumvent this:
     35 
     36 - open [phpmyadmin](http://localhost:8080). 
     37 - Navigate to `User accounts` tab and click the `lenasys` user.
     38 - Click `Login Information` and change the hostname to `%`.
     39 - Select `... delete the old one from the user tables and reload the privileges afterwards.`
     40 - Click `Go`.
     41 
     42 It should look like this:
     43 ![phpmyadmin screenshot](docs/change_hostname.png)