{"id":21678451,"url":"https://github.com/petervanderdoes/avh-deploy","last_synced_at":"2026-05-08T11:04:16.151Z","repository":{"id":12161534,"uuid":"14757313","full_name":"petervanderdoes/AVH-Deploy","owner":"petervanderdoes","description":"A toolkit for professional deployment using Capistrano v3.","archived":false,"fork":false,"pushed_at":"2013-11-27T19:47:20.000Z","size":108,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-01T23:41:47.695Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/petervanderdoes.png","metadata":{"files":{"readme":"README.mdown","changelog":null,"contributing":"CONTRIBUTING.mdown","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-27T19:46:48.000Z","updated_at":"2016-08-08T14:56:54.000Z","dependencies_parsed_at":"2022-09-23T04:33:53.860Z","dependency_job_id":null,"html_url":"https://github.com/petervanderdoes/AVH-Deploy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/petervanderdoes/AVH-Deploy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petervanderdoes%2FAVH-Deploy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petervanderdoes%2FAVH-Deploy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petervanderdoes%2FAVH-Deploy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petervanderdoes%2FAVH-Deploy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petervanderdoes","download_url":"https://codeload.github.com/petervanderdoes/AVH-Deploy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petervanderdoes%2FAVH-Deploy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32777651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-25T14:34:30.796Z","updated_at":"2026-05-08T11:04:16.133Z","avatar_url":"https://github.com/petervanderdoes.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"[wp]: http://wordpress.org/ \"Official WordPress site\"\n[wp-stack]: https://github.com/markjaquith/WP-Stack \"Mark Jaquith's WP-Stack on GitHub\"\n[rbenv]: https://github.com/sstephenson/rbenv \"rbenv on GitHub\"\n[capistrano-aa]: http://www.capistranorb.com/documentation/getting-started/authentication-and-authorisation/ \"Authentication \u0026 Authorisation documentation by Capistrano\"\n\n# AVH Deploy\nA toolkit for professional deployment using Capistrano v3.\n\nParts of the documentation and some of the tasks are geared towards [WordPress][wp] plugin or theme deployments, but the toolkit can be used for almost all sort of deployments.\n\nThis toolkit is based on the [WP Stack][wp-stack] deployment tool created by Mark Jaquith. His toolkit is for Capistrano v2 and is not compatible with the new Capistrano v3.\n\n## Why\nYou should have a professional deployment for your software. You should be using:\n\n* Version control (like Git). It's actually mandatory for AVH Deploy.\n* A code deployment system (like Capistrano)\n* A staging environment to test changes before they go live\n\nAdditionally, you should be able to easily scale out to multiple web servers, if needed.\n\nAVH Deploy is a toolkit that helps you do all that.\n\n## Capistrano\n\nCapistrano is a code deployment tool. When you have code that is ready to go \"live\", this is what does it.\n\n### Requirements\n\n#### Local system\n1. Ruby \u003e= 1.9 (JRuby and C-Ruby/YARV are supported)\n1. Git\n\n#### Server\n1. Git\n\n#### Authentication setup\nI could not write it better myself, so just follow the [Authentication \u0026 Authorisation][capistrano-aa] instructions of Capistrano itself\n\n### Setup\n\n#### Local system\n1. Install Ruby. I personally recommend using [rbenv][rbenv], but choose the installation method you are comfortable with.\n1. Checkout AVH Deploy `git clone git@github.com:petervanderdoes/AVH-Deploy.git /opt/avh-deploy`\n1. Go to the directory you checked out AVH Deploy and run `bundle install`\n1. Rename `config/deploy/{production|staging}_template.rb` to `config/deploy/{production|staging}.rb`\n1. Rename `config/deploy_template.rb` to `config/deploy.rb`\n1. Customize the above renamed files.\n\n#### Server\n1. Create the directory you defined at `set :deploy_to`\n\n### Deploying\n\n1. `cd` to the AVH Deploy directory.\n1. Run `cap production deploy` (to deploy to staging, use `cap staging deploy`)\n\n### Rolling Back\n\n1. `cd` to the AVH Deploy directory.\n1. Run `cap production deploy:rollback`\n\n### About Stages\n\nThere are two \"stages\": production and staging. These can be completely different servers, or different paths on the same set of servers.\n\n\n## Tasks\nIn `lib/capistrano/tasks` there are several tasks defined you can use for the deployment process. The tasks have \"documentation\" in the files themselves.\n\n### Extra info\n * This repository will be a rolling release, meaning we only use a master branch and we don't use tags.\n * Even though the documentation and certain tasks are geared towards WordPress you can use AVH Deploy for more than WordPress\n\n## Licence\n\nThe MIT License (MIT)\n\nCopyright (c) 2012-2013 Peter van der Does\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetervanderdoes%2Favh-deploy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetervanderdoes%2Favh-deploy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetervanderdoes%2Favh-deploy/lists"}