{"id":21297520,"url":"https://github.com/fvdm/lox-standard","last_synced_at":"2026-02-02T11:48:09.441Z","repository":{"id":28659316,"uuid":"32178812","full_name":"fvdm/lox-standard","owner":"fvdm","description":"Localbox public","archived":false,"fork":false,"pushed_at":"2015-02-16T01:42:50.000Z","size":63404,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-15T17:35:04.581Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"eupl-1.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fvdm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-13T20:18:10.000Z","updated_at":"2015-09-30T12:56:30.000Z","dependencies_parsed_at":"2022-08-24T10:10:19.678Z","dependency_job_id":null,"html_url":"https://github.com/fvdm/lox-standard","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvdm%2Flox-standard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvdm%2Flox-standard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvdm%2Flox-standard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvdm%2Flox-standard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fvdm","download_url":"https://codeload.github.com/fvdm/lox-standard/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fvdm%2Flox-standard/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259230542,"owners_count":22825409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T14:38:05.829Z","updated_at":"2026-02-02T11:48:04.394Z","avatar_url":"https://github.com/fvdm.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LocalBox\n\nLocalBox is built on top of the [Symfony](http://symfony.com) framework and the [YUI](http://yuilibrary.com) library.\n## Installation of the LAMP stack (you need this)\nFor CentOS/Ubuntu:\n\nyum install php httpd mariadb-server php-bcmath php-mbstring php-pdo git php-xml php-mysql php-intl\n\napt-get install apache mariadb-server php-bcmath php-mbstring php-pdo git php-xml php-mysql php-intl\n\n# install composer\ncurl -sS https://getcomposer.org/installer | php\n\nmv composer.phar /usr/local/bin/composer\n\nchmod +x /usr/local/bin/composer\n\n\n## Installation from the github repository:\n\ngit clone ${localboxurl}\n\nin this case:\n\ngit clone https://github.com/TweedeKamer/lox-standard /usr/share/lox-standard (or any pre-directory of your liking)\n\ncd lox-standard\n\nbefore we update composer, make sure you have enough memory for it.\n\nlook in your /etc/php.ini or/and the /etc/php5/cli\n\nfor the parameter: memory_limit make it at least 2048M\n\ncomposer is a little bit memory hungry when its installing and updating.\n\nIts smart to update 2 more parameters,find post_max_size make it 4096M\n\nand upload_max_filesize make it 4096M.\n\nso your user can send bigger files to the box.\n\nThere are plenty more settings to fiddle with but that's up to you.\n\n## Update the vendor library\n\nnext give the following command: composer update\n\nYou have to wait a while, go walk the dog or drink some coffee:-)\nIf all go's well you can try to do a post install.\n\nnote: if you don't have a valid parameters.yml it wil ask you for the settings, you can fill it in thats ok,\nbut you have to use ofcourse the same value's as below with a new installation.\nYou can alway's copy the parameters.yml.dist to parameters.yml and manually edit the file.\n\n## Starting your engines.\n\n# for boot\n\nsystemctl enable httpd.service\n\nsystemctl enable mariadb.service\n\n# for now\n\nsystemctl start httpd.service\n\nsystemctl start mariadb.service\n\n## For a new installation\nFor a brand new install it is easier to create the database first with a database owner.\n\nfirst run: mysql_secure_installation\n\nto tighten the databses if your not done that already.(remebered you pwd?)\nthen:\n\nmysql -h localhost -u root -p \u003cyour pwd\u003e\n\nMariaDB [(none)]\u003e CREATE DATABASE localbox;\n\nMariaDB [(none)]\u003e GRANT ALL PRIVILEGES ON localbox.* TO 'localbox'@'localhost' IDENTIFIED BY '\u003cyourownpwd';\n\nMariaDB [(none)]\u003e FLUSH PRIVILEGES;\n\nexit\n\nstanding in you localbox root directory (cd /usr/share/localbox)\n\napp/deployment/post-install.sh\n\n## Some things to check:\ndo you have a data directory?\n\nmkdir /usr/share/lox-standard/data\n\nMake sure the data app/cache app/logs folders are writable for httpd  (mostly apache, or www-data)\n\ncd /usr/share/lox-standard\n\nchown -R apache data app/cache app/logs\n\ndon't use a alias in your apache config , it's better to set its documentroot to /usr/share/lox-standard/web\n\nWe removed some (install) scripts because the were out of date, and we are working on the rpm system to replace most of the\n scripting.and are working on a WiKi and improving the web site , so most of the documentation and guides will be published\non wiki.yourlocalbox.org overtime.\n\nHappy Boxing;-)\n\n## Installation from RPM not yet possible :-( but coming soon\n\nyum install localbox\\*-${version}.rpm\n\ncreate a app/parameters.yml based on app/parameters.yml.dist\n\napp/deployment/post-install.sh\n\n\n\n# Deprecated information??not all of it:-)\n\n## Installing LocalBox using the installer script\n\nThe installer script was tested on Ubuntu (12.04/14.04), Debian (Wheezy 7) and CentOS (6.5).\n\nYou can find the installer scripts in the app/deployment folder.\n\n### Before installing\n\n* Make sure you have sudo rights on the machine\n\n* Extract the contents of the archive to the desired folder. Choose a folder that is recommended for your system or which has your preference.\n\n* If MySQL is already installed on your system, make sure you know the root password\n\n* Make sure you are in the LocalBox root-folder (default this is \"lox-standard\").\n\n* Make sure the install script is executable, by executing the following command:\n\nFor Ubuntu (12.04/14.04) or Debian (Wheezy 7) based systems:\n\n    [sudo] chmod +x ./app/deployment/install-apt.sh\n\nFor CentOs (6.5) or RHEL (6) based systems:\n\n    [sudo] chmod +x ./app/deployment/install-yum.sh\n\n### Installing\n* When you are ready to install LocalBox, execute the following command and follow the instructions on-screen:\n\nFor Ubuntu (12.04/14.04) or Debian (Wheezy 7) based systems:\n\n    [sudo] ./app/deployment/install-apt.sh\n\nFor CentOs (6.5) or RHEL (6) based systems:\n\n    [sudo] ./app/deployment/install-yum.sh\n\n*Important:* The above command should be executed from the LocalBox root-folder (default this is \"lox-standard\" ).\n\nYou will be prompted to deliver the MySQL password, and to add a database user for the database that LocalBox will create.\n\nDuring the installation you will be prompted to install MySQL, Apache and PHP. You have the possibilty to choose not to install these, but be sure that you made the correct changes in order to support the LocalBox application.\n\n### After installing\n\n* If Apache was not installed before you ran the install script, the script will have configured Apache for you. This means that you can now type your machine's hostname or ip-address in a browser, and you will see the LocalBox login page. You can log in for the first time using the default admin credentials (see the section \"Default User Accounts\" in this document).\n\n* If Apache was already installed before you ran the install script, you should now configure Apache. Make sure that the following directory is accessible to Apache and the right permissions are set:\n\n       */lox-standard/web*\n\n* If you're running a webserver other than Apache2 make sure that mod-rewrite is enabled, and make sure that the webserver user and command line user have the right permission on the following folders:\n\n       */lox-standard/app/cache*\n       */lox-standard/app/logs*\n       */lox-standard/data*\n\n## Updating LocalBox using the update script\n\n### Before updating\n\nIt is really important that you make a copy of the data folder and the file /app/config/parameters.yml in your LocalBox installation. Place this copy in a safe place (for instance, your home folder). We will need this data folder and parameters.yml later on in the update process.\n\n### Removing the lox-standard folder\n\nNext, we will remove the entire lox-standard folder. Go to the folder where this folder is located (for instance /var/www or /opt) and execute the following command:\n\n    rm -rf lox-standard\n\n### Extracting the new LocalBox files\n\nGo to the folder where the .tar.gz-file of the new LocalBox version is located, and extract it to the appropriate folder (for instance /var/www or /opt).\n\n    tar -xzvf [filename].tar.gz -C /[pathname]\n\nSo for instance:\n\n    tar -xzvf localbox-v2.4.1.tar.gz -C /var/www\n\n### Copying back the data folder and parameters.yml\n\nGo to the folder where you stored a copy of both the data folder and the file parameters.yml, and copy them to your new lox-standard folder. For instance:\n\n    [sudo] cp -rf /home/admin/paramaters.yml /var/www/app/config/parameters.yml\n    [sudo] cp -rf /home/admin/data /var/www/app/config/data\n\n### Running the update script\n\nNow run the update script:\n\n    [sudo] app/deployment/post-update.sh\n\n## Installing Localbox manually\n\n### System Requirements\n\n* PHP needs to be a minimum version of PHP 5.3.3\n* Your php.ini needs to have the date.timezone setting\n* The PHP intl extension needs to be installed\n* MySQL needs to be installed\n* *Optional:* To enable LocalBox's encryption capabilities, your PHP should support mcrypt- and openssl-functionality. Depending on your Linux distribution, this is either included in php or it can be installed through the packages php5-mcrypt and php5-openssl. Ubuntu 12.04 and higher already has openssl-support in PHP.\n\n### Downloading project dependencies\n\n1. Clone the repository, open the console and navigate to the directory.\n\n2. Install composer, if you don't have it yet.\n\n        curl -sS https://getcomposer.org/installer | php\n\n3. The `app/cache` directory should be  writable for the composer post-install scripts to execute. The easiest way to do so is:\n\n        [sudo] chmod 777 app/cache\n\n4. Download dependencies. Enter default values (press enter) for the `parameters.yml` if prompted.\n\n        php composer.phar install\n\n### Initializing Symfony\n\nTo check the system configuration, run the check.php script from the command line, in the application's root directory:\n\n    php app/check.php\n\nIf you get any warnings or recommendations, fix them before moving on.\n\nBasic Symfony console commands that need to be executed from the application's root directory.\n\n#### Initializing a new installation\n\nExecute the following commands after setting up a **new** LocalBox installation:\n\n1. Edit the `app/config/parameters.yml` file and set the required values for your specific environment.\n\n2. Run the post installation script:\n\n        [sudo] app/deployment/post-install.sh\n\nThe installation script uses 777 permissions on the writable dirs for platform portability. For more restrictive permissions, use something like ACL, depending on your platform. Write permissions are required for both the console user and the apache user.\n\n#### Initializing an updated installation\n\nExecute the following commands after updating an **existing** LocalBox installation:\n\n1. Edit the `app/config/parameters.yml` file and set the required values for your specific environment.\n\n2. Run the post update script:\n\n        [sudo] app/deployment/post-update.sh\n\nThe update script uses 777 permissions on the writable dirs for platform portability. For more restrictive permissions, use something like ACL, depending on your platform. Write permissions are required for both the console user and the apache user.\n\n**Caution**: The update script might not work properly when using an older proof-of-concept version of LocalBox, especially if there are duplicate entries in the Items-table of your database. Should you encounter problems while running the update script on an old proof-of-concept version of LocalBox, we recommend that you do a full clean install instead.\n\n## Default User Accounts\n\nTwo default accounts are created, an admin account:\n\n    username: admin\n    password: adminpasswd\n\nA standard user account:\n\n    username: user\n    password: userpasswd\n\n## Administration\n\nUsers and groups can be managed by an admin from the following URL:\n\n    http://host/admin/dashboard\n\n## API Documentation\n\nAPI documentation can be found on the following URL:\n\n    http://host/api/doc\n\n## Development\n\n### Testing\n\n1.  To run the test suite you'll need PHPUnit:\n\n        phpunit -c app/\n\n## About\n\nLocalBox is a Hocosta and Department of EZ initiative.Developed by [LiBBiT](http://www.libbit.eu)\nMore information is found on [wesharesafe.org](http://www.wesharesafe.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffvdm%2Flox-standard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffvdm%2Flox-standard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffvdm%2Flox-standard/lists"}