{"id":13852497,"url":"https://github.com/TryGhost/Ghost-Vagrant","last_synced_at":"2025-07-13T05:33:12.316Z","repository":{"id":8334293,"uuid":"9889177","full_name":"TryGhost/Ghost-Vagrant","owner":"TryGhost","description":"Vagrant setup for developing Ghost","archived":true,"fork":false,"pushed_at":"2018-08-11T01:21:54.000Z","size":38764,"stargazers_count":226,"open_issues_count":8,"forks_count":56,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-10-30T00:54:52.967Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Puppet","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/TryGhost.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":"2013-05-06T14:56:43.000Z","updated_at":"2024-02-01T15:13:43.000Z","dependencies_parsed_at":"2022-08-07T02:32:32.886Z","dependency_job_id":null,"html_url":"https://github.com/TryGhost/Ghost-Vagrant","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/TryGhost%2FGhost-Vagrant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2FGhost-Vagrant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2FGhost-Vagrant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2FGhost-Vagrant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TryGhost","download_url":"https://codeload.github.com/TryGhost/Ghost-Vagrant/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225751297,"owners_count":17518513,"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-08-04T22:01:22.862Z","updated_at":"2024-11-22T07:30:26.410Z","avatar_url":"https://github.com/TryGhost.png","language":"Puppet","funding_links":[],"categories":["Puppet"],"sub_categories":[],"readme":"# Ghost-Vagrant\n\nA development environment for [Ghost](https://ghost.org) using [Vagrant](http://www.vagrantup.com/downloads.html).\n\n## Prerequisites\n\nYou will need the following applications to setup the Ghost development environment:\n\n- [Vagrant](http://www.vagrantup.com/downloads.html)\n- [VirtualBox](https://www.virtualbox.org/wiki/Downloads)\n- [Git](https://git-scm.com/downloads)\n\nLinux users will also need `nfs-common` and `nfs-kernel-server`:\n\n```bash\nsudo apt-get install nfs-common nfs-kernel-server\n```\n\nWindows users should install Vagrant to a directory with no spaces in the path.\n\n## Setup\n\nTo get started with the Ghost development environment, you will first need to clone this repo:\n\n```bash\ngit clone git://github.com/TryGhost/Ghost-Vagrant.git\n```\n\nClone the Ghost repo into your new local Ghost-Vagrant repo:\n\n```bash\ncd Ghost-Vagrant\ngit clone git://github.com/Tryghost/Ghost.git\n```\n\nNow we have both repos cloned, we can proceed with setting up the VM:\n\n```bash\nvagrant up\n```\n\nOnce the VM has been setup, you will need to log in to the VM and setup Ghost:\n\n```bash\nvagrant ssh\n\n# When logged into the VM...\n\ncd code/Ghost\nnpm install\ngrunt init\n```\n\nOn the host you should now be able to access Ghost by navigating to `local.tryghost.org` or `192.168.33.10` in your browser. Make sure to update the development URL to `http://local.tryghost.org` in `Ghost/config.js`.\n\n## Stopping and Starting Ghost\n\nOnce you have been through the setup process above, you can stop Ghost by logging in to the VM (`vagrant ssh`) and running:\n\n```bash\nsudo stop app\n```\n\nTo start Ghost again run:\n\n```bash\nsudo start app\n```\n\nIf you do not want to use the service for starting and stopping Ghost, you can alternatively run:\n\n```bash\nnpm start\n```\n\nThis is useful when you want to debug what Ghost is doing when it boots up, what URLs are being accessed etc.\n\n## Configuring the VM\n\nYou can configure various properties of the VM by creating a file named `vm_config.yml` in the `Ghost-Vagrant` root directory. The following properties are configurable:\n\n- **hostname** - URI that will be used to access Ghost from the browser\n- **ip** - IP address assigned to the virtual machine\n- **memory** - Amount of memory the virtual machine should have\n- **ghost_path** - Path to Ghost installation\n\n```yml\nhostname: local.tryghost.org\nip: 192.168.33.10\nmemory: 1024\nghost_path: ./Ghost\n```\n\nIf `vm_config.yml` is not present when you first run `vagrant up`, it will be automatically created with the default values found in [.vm_config_default.yml](.vm_config_default.yml).\n\n## Developing and Running Tests\n\nSee the [working on Ghost core](https://github.com/TryGhost/Ghost/blob/master/.github/CONTRIBUTING.md#core) section of the Ghost [contributing guide](https://github.com/TryGhost/Ghost/blob/master/.github/CONTRIBUTING.md).\n\n## Troubleshooting\n\nIf `grunt init` fails due to an `npm` error `EEXIST` regarding a `.lock` file, try:\n\n```\nrm -rf core/client/node_modules\nnpm cache clear\ngrunt init\n```\n\n## Copyright \u0026 License\n\nCopyright (c) 2013-2018 Ghost Foundation - Released under the [MIT license](LICENSE). Ghost and the Ghost Logo are trademarks of Ghost Foundation Ltd. Please see our [trademark policy](https://ghost.org/trademark/) for info on acceptable usage.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTryGhost%2FGhost-Vagrant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTryGhost%2FGhost-Vagrant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTryGhost%2FGhost-Vagrant/lists"}