{"id":17035706,"url":"https://github.com/xety/serverpilot","last_synced_at":"2025-03-22T22:41:09.066Z","repository":{"id":84557299,"uuid":"47655771","full_name":"Xety/ServerPilot","owner":"Xety","description":"Setup ServerPilot with Vagrant","archived":false,"fork":false,"pushed_at":"2018-03-11T13:25:10.000Z","size":6,"stargazers_count":16,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-18T04:37:38.599Z","etag":null,"topics":["local","serverpilot","tutorial"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xety.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-08T23:24:37.000Z","updated_at":"2020-06-17T13:57:42.000Z","dependencies_parsed_at":"2023-03-11T08:45:18.116Z","dependency_job_id":null,"html_url":"https://github.com/Xety/ServerPilot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xety%2FServerPilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xety%2FServerPilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xety%2FServerPilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xety%2FServerPilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xety","download_url":"https://codeload.github.com/Xety/ServerPilot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245031257,"owners_count":20549912,"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":["local","serverpilot","tutorial"],"created_at":"2024-10-14T08:47:49.545Z","updated_at":"2025-03-22T22:41:09.040Z","avatar_url":"https://github.com/Xety.png","language":null,"readme":"## Setup ServerPilot with Vagrant\n\nThis repository provides a sample Vagrantfile to create a Ubuntu 14.04 64-bit virtual machine. After following the installation instructions, you'll have a server managed by ServerPilot and accessible via your browser at `local.io`.\nInspired from [manjoker/Vagrantfile](https://github.com/manjoker/Vagrantfile)\n\nhttps://serverpilot.io\n\n## Information\nYou will be able to setup as many sub-domain as you want. You will have phpMyAdmin running on your server and you will also be able to share your virtual machine with https://vagrantcloud.com\n\n## Getting Started\n1. Install dependencies\n  * [Virtualbox](https://www.virtualbox.org/) 4.0 or greater.\n  * [Vagrant](http://downloads.vagrantup.com/) 1.3.1 or greater.\n2. Copy the [Vagrantfile](https://github.com/Xety/ServerPilot/blob/master/Vagrantfile)\n3. Execute the following commands to setup the virtual machine :\n```bash\n$ vagrant up\n$ vagrant ssh\n```\n\n## Connecting to ServerPilot\n  * [Log in](https://manage.serverpilot.io/#login) to ServerPilot\n  * Go to the **Servers** page and click **+ Connect Server**\n  * Click `Install ServerPilot manually.` at the bottom\n    * `Name` =\u003e `local.io`\n    * `SFTP Password` =\u003e `Choose a password`\n  * Copy the **whole** command (and let the page open in your browser):\n![fdf4c72543af0a52e47b3474b150e93b](https://cloud.githubusercontent.com/assets/8210023/11672449/e0f1da26-9e10-11e5-84f0-2b3229e75c48.png)\n\n  * Paste the command in the VM terminal and wait until to get this message :\n![c5d6522793686dbc0ab42d75e5be7df1](https://cloud.githubusercontent.com/assets/8210023/11672125/f12bf9ce-9e0d-11e5-8a8c-8f18ee4c799e.png)\n\n  * Watch **ServerPilot** install\n![55a2c4882b4e624ef61a49d5de59c32a](https://cloud.githubusercontent.com/assets/8210023/11672081/8cdad1d4-9e0d-11e5-8640-e1a7d3b744a7.png)\n  * **Note** : The part `Testing server configuration` **may take several minutes** (more than 20 minutes for me)\n\n## Create your Applications in ServerPilot\n  * Go to the **Apps** page and click **+ Create App**\n    * `Name` =\u003e `website`\n    * `Domain` =\u003e `local.io`\n    * `Server` =\u003e `local.io`\n\n## Edit the `hosts` file\n  * Edit the following file as `administrator` / `root`\n    * Ubuntu/Mac OS X : `/etc/hosts`\n    * Windows : `C:\\WINDOWS\\system32\\drivers\\etc\\hosts`\n  * Add the following code in this file :\n    * `192.168.56.101 local.io`\n    * If you plan to add sub-domains, you can add them now in the `hosts` file :\n```\n192.168.56.101 local.io\n192.168.56.101 subdomain1.local.io\n192.168.56.101 subdomain2.local.io\n```\n\n## Edit the `Vagrantfile` file\n  * Now, you must edit the `Vagrantfile` and **uncomment** this line :\n```ruby\nconfig.vm.synced_folder '/var/www/Sites/website', '/srv/users/serverpilot/apps/website/public', owner: \"serverpilot\", group: \"serverpilot\"\n```\n  * Adapt it to your system. The first part, is the path on **your** system. The second part, is the path on the VM system.\n    * **Note** : Don't remove the `owner` and `group` keys. I have got some issues with the permissions, and this configuration seems to resolve all permissions bugs. If you want to add new `synced_folder`, you must add the `owner` and `group` keys with the `serverpilot` value.\n  * Execute the following command to reload the VM with the modified Vagranfile :\n```bash\nvagrant@local:~$ exit\n$ vagrant reload\n```\n\n## Enjoy\n  * Go to [local.io](http://local.io) in a new tab and you should see the ServerPilot splash page **or** your application.\n![6f7a24856a34bdc310657e9d92d6655c](https://cloud.githubusercontent.com/assets/8210023/11673405/d519a794-9e18-11e5-940b-a7104484b9aa.png)\n\n\n# More Configuration\nThe following configuration are not required, but can be usefull if you plan to install phpMyAdmin or setup a sub-domain.\n\n### Install `phpMyAdmin`\n  * Create a new application on ServerPilot :\n    * `Name` =\u003e `pma`\n    * `Domain` =\u003e `pma.local.io`\n    * `Server` =\u003e `local.io`\n  * Download the latest version of `phpMyAdmin` :\n    * http://www.phpmyadmin.net/home_page/downloads.php\n  * Open the archive that you downloaded\n  * Place the archive where you want on your system. For the tutorial, i have placed it in `/var/www/Sites/pma`.\n  * Rename `config.sample.inc.php` to `config.inc.php`.\n  * Now, open `config.inc.php` and set a random string of characters for the value of ``$cfg['blowfish_secret']`` near the top of the file. Exemple :\n```php\n$cfg['blowfish_secret'] = 'asdof7q230984(*^3q4';\n```\n\n  * Add `192.168.56.101 pma.local.io` to your `hosts` file.\n  * Uncomment and adapt (regarding to the path) the following line in the Vagranfile :\n```ruby\nconfig.vm.synced_folder '/var/www/Sites/pma', '/srv/users/serverpilot/apps/pma/public', owner: \"serverpilot\", group: \"serverpilot\"\n```\n  * Execute the following command to reload the VM with the modified Vagranfile :\n```bash\n$ vagrant reload\n```\n  * Create a database on ServerPilot :\n![280552ce196fca4efcc75bb31060c1c2](https://cloud.githubusercontent.com/assets/8210023/11673299/f894f1fc-9e17-11e5-82eb-a7fe91dabd72.png)\n\n  * Go to [pma.local.io](http://pma.local.io) and login with the same `username` and `password` that you used to create the database.\n\n### Create a `sub-domain`\n  * If you followed the phpMyAdmin installation, you already know how to setup a sub-domain. For the tutorial, I will setup a sub-domain named `xety.local.io`\n  * Create a new application on ServerPilot :\n    * `Name` =\u003e `xety`\n    * `Domain` =\u003e `xety.local.io`\n    * `Server` =\u003e `local.io`\n  * Add `192.168.56.101 xety.local.io` to your `hosts` file.\n  * Uncomment and adapt (regarding to your path) the following line in the Vagranfile :\n```ruby\nconfig.vm.synced_folder '/var/www/Sites/xety', '/srv/users/serverpilot/apps/xety/public', owner: \"serverpilot\", group: \"serverpilot\"\n```\n  * Execute the following command to reload the VM with the modified Vagranfile :\n```bash\n$ vagrant reload\n```\n  * Go to [xety.local.io](http://xety.local.io) and enjoy ! Yes, it's very simple to do.\n\n### Connect to the `SFTP`\nYes, you can connect to the server using the SFTP method !\n  * Use your prefered software. I will use `FileZilla`.\n  * Login in FileZilla with the following credentials :\n    * `Host` =\u003e `192.168.56.101`\n    * `User` =\u003e `serverpilot`\n    * `Password` =\u003e `The SFTP password that you provided at the beginning of this tutorial`\n    * `Port` =\u003e `22`\n  * You can also login with the `vagrant` user :\n    * `Host` =\u003e `192.168.56.101`\n    * `User` =\u003e `vagrant`\n    * `Password` =\u003e `vagrant`\n    * `Port` =\u003e `22`\n  * But **i recommend** you to use the `serverpilot` user and not the `vagrant`, else you will probably have some permissions issues (i.e : https://serverpilot.io/community/articles/how-to-fix-file-permissions.html)\n\n### Share your VM\n  * Create an account there : https://vagrantcloud.com/account/new\n  * It's easy with 1 command, follow the `HTTP` method there : https://vagrantcloud.com/help/vagrant/shares/create\n  * Possible issue :\n    * `Why the share doesn't show the good application ?` =\u003e Because ServerPilot define the default application by alphabetically order. More information : https://serverpilot.io/community/articles/how-to-set-the-default-app.html\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxety%2Fserverpilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxety%2Fserverpilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxety%2Fserverpilot/lists"}