{"id":26730313,"url":"https://github.com/mayerbalintdev/gym-one-installer","last_synced_at":"2026-04-29T18:35:14.894Z","repository":{"id":284607492,"uuid":"954884024","full_name":"mayerbalintdev/GYM-One-Installer","owner":"mayerbalintdev","description":"The GYM One Installer simplifies the installation and setup of the GYM One gym management software. It automates the configuration of PHP, database, and other necessary settings, making it easy to deploy GYM One on any web server with PHP 8.0+.","archived":false,"fork":false,"pushed_at":"2025-03-26T18:07:45.000Z","size":16494,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T19:25:07.433Z","etag":null,"topics":["free","gym","gym-management-system","gymone","gymoneinstaller","installer","php","software","sql","ubuntu"],"latest_commit_sha":null,"homepage":"https://gymoneglobal.com/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mayerbalintdev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-25T19:06:06.000Z","updated_at":"2025-03-26T18:09:48.000Z","dependencies_parsed_at":"2025-03-26T19:35:11.306Z","dependency_job_id":null,"html_url":"https://github.com/mayerbalintdev/GYM-One-Installer","commit_stats":null,"previous_names":["mayerbalintdev/gym-one-installer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayerbalintdev%2FGYM-One-Installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayerbalintdev%2FGYM-One-Installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayerbalintdev%2FGYM-One-Installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayerbalintdev%2FGYM-One-Installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mayerbalintdev","download_url":"https://codeload.github.com/mayerbalintdev/GYM-One-Installer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245938309,"owners_count":20697017,"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":["free","gym","gym-management-system","gymone","gymoneinstaller","installer","php","software","sql","ubuntu"],"created_at":"2025-03-27T23:19:17.320Z","updated_at":"2026-04-29T18:35:14.882Z","avatar_url":"https://github.com/mayerbalintdev.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://gymoneglobal.com/assets/img/text-color-logo.png\" alt=\"GYM One Logo\" width=\"320\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eGYM One — Installer\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/mayerbalintdev/GYM-One-Installer/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/version-1.3.0-blue.svg\" alt=\"Version\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/PHP-%3E%3D8.1-777BB4?logo=php\u0026logoColor=white\" alt=\"PHP\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MySQL-%3E%3D5.7-4479A1?logo=mysql\u0026logoColor=white\" alt=\"MySQL\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Ubuntu%20%7C%20Apache%20%7C%20Nginx-lightgrey\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  The official installer for GYM One — automatically configures your server environment, sets up the database, and gets your gym management system running in minutes.\n\u003c/p\u003e\n\n---\n\n## 📋 Table of Contents\n\n1. [Requirements](#-requirements)\n2. [Before You Begin](#-before-you-begin)\n3. [Installation Steps](#-installation-steps)\n4. [Post-Installation](#-post-installation)\n5. [Troubleshooting](#-troubleshooting)\n6. [Updating from a Previous Version](#-updating-from-a-previous-version)\n7. [Support](#-support)\n\n---\n\n## ⚙️ Requirements\n\nBefore running the installer, make sure your server meets the following requirements:\n\n| Requirement | Minimum Version |\n|---|---|\n| PHP | 8.1 or higher |\n| MySQL / MariaDB | 5.7 / 10.4 or higher |\n| Web Server | Apache 2.4+ or Nginx 1.18+ |\n| Composer | Latest stable |\n| OS | Ubuntu 20.04+ recommended |\n\n### Required PHP Extensions\n\nThe following PHP extensions must be enabled:\n\n- `pdo_mysql`\n- `mbstring`\n- `openssl`\n- `tokenizer`\n- `xml`\n- `curl`\n- `zip`\n- `gd`\n\n\u003e You can check your PHP extensions with `php -m` on the server.\n\n---\n\n## 🔍 Before You Begin\n\n- Make sure your web server is running and accessible\n- Have your MySQL credentials ready (host, database name, username, password)\n- Ensure the web server has **write permissions** on the target directory\n- It is recommended to run the installer on a **clean server** or a **fresh directory** — do not install over an existing GYM One instance without backing up first\n\n---\n\n## 🚀 Installation Steps\n\n### 1. Upload Installer Files\n\nUpload the GYM One installer files to the root directory of your web server (e.g., `/var/www/html/`).\n\nAll files must be accessible via the web server:\n```\nhttp://your-server-ip/\n```\n\n### 2. Open the Installer\n\nNavigate to the installer URL in your web browser:\n```\nhttp://your-server-ip/\n```\n\nThe installer will launch automatically and guide you through each step.\n\n### 3. System Check\n\nThe installer will first run a **system compatibility check**, verifying:\n- PHP version and required extensions\n- File and directory permissions\n- Database connectivity\n\nFix any issues flagged in red before proceeding.\n\n### 4. Database Configuration\n\nProvide your database connection details:\n- **Host** (usually `localhost`)\n- **Database name**\n- **Username**\n- **Password**\n\nThe installer will create the required tables and seed the initial data automatically.\n\n### 5. Application Configuration\n\nSet up your initial application settings:\n- Site name and URL\n- Default timezone\n- Admin account credentials (email + password)\n- Optional: SMTP email settings for notifications\n\n### 6. Finish Installation\n\nClick **\"Finish Installation\"** once all steps are complete. The installer will:\n- Write the configuration files\n- Set up directory permissions\n- Remove installer access for security\n\n### 7. Access GYM One\n\nYour GYM One instance is now live at:\n```\nhttp://your-server-ip/\n```\nor\n```\nhttp://your-domain.com/\n```\n\nLog in with the admin credentials you set in Step 5.\n\n\u003e ⚠️ **Important:** Delete or restrict access to the installer directory after installation is complete to prevent unauthorized re-installation.\n\n---\n\n## 🔧 Post-Installation\n\nAfter completing the installation, we recommend the following:\n\n- **Set up HTTPS** — Use Let's Encrypt or a commercial SSL certificate\n- **Configure email (SMTP)** — Required for membership notifications and reminders\n- **Set up automated backups** — Regularly back up your database and uploaded files\n- **Review file permissions** — Ensure sensitive directories (e.g., `config/`, `storage/`) are not publicly accessible\n- **Test the admin panel** — Verify all modules are working correctly before going live\n\n---\n\n## 🛠️ Troubleshooting\n\n### Installer won't load\n- Check that your web server is running (`systemctl status apache2` or `nginx`)\n- Verify the files are in the correct directory and accessible via the browser\n\n### Database connection error\n- Double-check your credentials and ensure MySQL is running (`systemctl status mysql`)\n- Make sure the database user has sufficient privileges (`GRANT ALL ON db.* TO 'user'@'localhost'`)\n\n### Missing PHP extensions\n- Install missing extensions, e.g.: `sudo apt install php8.1-mbstring php8.1-xml php8.1-zip php8.1-gd`\n- Restart your web server after installing extensions\n\n### Permission errors\n- Run `sudo chown -R www-data:www-data /var/www/html/` and `sudo chmod -R 755 /var/www/html/`\n\n### Still stuck?\n- Check web server logs: `/var/log/apache2/error.log` or `/var/log/nginx/error.log`\n- Check PHP logs: `/var/log/php*.log`\n- Visit the [GYM One Documentation](https://gymoneglobal.com/docs) for detailed guides\n\n---\n\n## 🔄 Updating from a Previous Version\n\nIf you are upgrading from an earlier version of GYM One:\n\n1. **Back up your database** before doing anything else\n2. **Back up your configuration files** (e.g., `.env`, `config/`)\n3. Upload the new installer files to your server\n4. Follow the on-screen upgrade instructions — the installer will detect your existing installation\n5. Verify all settings and test thoroughly after the upgrade\n\n\u003e Skipping backups before an upgrade is strongly discouraged.\n\n---\n\n## 📬 Support\n\nIf you have questions or run into issues during installation, we're here to help:\n\n- **Documentation:** [https://gymoneglobal.com/docs](https://gymoneglobal.com/docs)\n- **Email:** [center@gymoneglobal.com](mailto:center@gymoneglobal.com)\n- **Website:** [https://gymoneglobal.com](https://gymoneglobal.com)\n- **GitHub Issues:** [Open an issue](https://github.com/mayerbalintdev/GYM-One-Installer/issues)\n\nPress inquiries: [press@gymoneglobal.com](mailto:press@gymoneglobal.com)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Thank you for choosing GYM One! 💪\u003cbr\u003e\n  \u003ci\u003eVersion 1.3.0 — Built with passion for the fitness community.\u003c/i\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayerbalintdev%2Fgym-one-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmayerbalintdev%2Fgym-one-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayerbalintdev%2Fgym-one-installer/lists"}