{"id":13519091,"url":"https://github.com/jolicode/docker-starter","last_synced_at":"2025-03-31T12:31:12.089Z","repository":{"id":39636154,"uuid":"195810135","full_name":"jolicode/docker-starter","owner":"jolicode","description":"🏗️ A skeleton to start a new web project with PHP, Docker and Castor","archived":false,"fork":false,"pushed_at":"2025-03-21T11:15:24.000Z","size":3372,"stargazers_count":346,"open_issues_count":4,"forks_count":36,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-03-21T12:26:40.787Z","etag":null,"topics":["castor","docker","docker-compose","github-template","hacktoberfest","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/jolicode.png","metadata":{"files":{"readme":"README.dist.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2019-07-08T12:44:51.000Z","updated_at":"2025-03-21T11:15:27.000Z","dependencies_parsed_at":"2023-10-11T21:25:43.550Z","dependency_job_id":"dd03704d-b15c-4429-883b-8f0048208f64","html_url":"https://github.com/jolicode/docker-starter","commit_stats":null,"previous_names":[],"tags_count":15,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fdocker-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fdocker-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fdocker-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fdocker-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jolicode","download_url":"https://codeload.github.com/jolicode/docker-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246469086,"owners_count":20782663,"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":["castor","docker","docker-compose","github-template","hacktoberfest","php"],"created_at":"2024-08-01T05:01:53.773Z","updated_at":"2025-03-31T12:31:12.083Z","avatar_url":"https://github.com/jolicode.png","language":"PHP","readme":"# My project\n\n## Running the application locally\n\n### Requirements\n\nA Docker environment is provided and requires you to have these tools available:\n\n * Docker\n * Bash\n * [Castor](https://github.com/jolicode/castor#installation)\n\n#### Castor\n\nOnce `castor` is installed, in order to improve your usage of `castor` scripts, you\ncan install console autocompletion script.\n\nIf you are using bash:\n\n```bash\ncastor completion | sudo tee /etc/bash_completion.d/castor\n```\n\nIf you are using something else, please refer to your shell documentation. You\nmay need to use `castor completion \u003e /to/somewhere`.\n\n`castor` supports completion for `bash`, `zsh` \u0026 `fish` shells.\n\n### Docker environment\n\nThe Docker infrastructure provides a web stack with:\n - NGINX\n - PostgreSQL\n - PHP\n - Traefik\n - A container with some tooling:\n   - Composer\n   - Node\n   - Yarn / NPM\n\n### Domain configuration (first time only)\n\nBefore running the application for the first time, ensure your domain names\npoint the IP of your Docker daemon by editing your `/etc/hosts` file.\n\nThis IP is probably `127.0.0.1` unless you run Docker in a special VM (like docker-machine for example).\n\n\u003e [!NOTE]\n\u003e The router binds port 80 and 443, that's why it will work with `127.0.0.1`\n\n```\necho '127.0.0.1 \u003cyour hostnames\u003e' | sudo tee -a /etc/hosts\n```\n\n### Starting the stack\n\nLaunch the stack by running this command:\n\n```bash\ncastor start\n```\n\n\u003e [!NOTE]\n\u003e the first start of the stack should take a few minutes.\n\nThe site is now accessible at the hostnames you have configured over HTTPS\n(you may need to accept self-signed SSL certificate if you do not have `mkcert`\ninstalled on your computer - see below).\n\n### SSL certificates\n\nHTTPS is supported out of the box. SSL certificates are not versioned and will\nbe generated the first time you start the infrastructure (`castor start`) or if\nyou run `castor docker:generate-certificates`.\n\nIf you have `mkcert` installed on your computer, it will be used to generate\nlocally trusted certificates. See [`mkcert` documentation](https://github.com/FiloSottile/mkcert#installation)\nto understand how to install it. Do not forget to install CA root from `mkcert`\nby running `mkcert -install`.\n\nIf you don't have `mkcert`, then self-signed certificates will instead be\ngenerated with `openssl`. You can configure [infrastructure/docker/services/router/openssl.cnf](infrastructure/docker/services/router/openssl.cnf)\nto tweak certificates.\n\nYou can run `castor docker:generate-certificates --force` to recreate new certificates\nif some were already generated. Remember to restart the infrastructure to make\nuse of the new certificates with `castor up` or `castor start`.\n\n### Builder\n\nHaving some composer, yarn or other modifications to make on the project?\nStart the builder which will give you access to a container with all these\ntools available:\n\n```bash\ncastor builder\n```\n\n### Other tasks\n\nCheckout `castor` to have the list of available tasks.\n","funding_links":[],"categories":["PHP"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fdocker-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjolicode%2Fdocker-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fdocker-starter/lists"}