{"id":36660997,"url":"https://github.com/dshoreman/servidor","last_synced_at":"2026-01-12T10:27:48.571Z","repository":{"id":37534869,"uuid":"150923447","full_name":"dshoreman/servidor","owner":"dshoreman","description":"A modern web application for managing servers","archived":false,"fork":false,"pushed_at":"2023-03-19T22:28:29.000Z","size":5196,"stargazers_count":8,"open_issues_count":30,"forks_count":10,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2023-03-22T22:51:46.425Z","etag":null,"topics":["hacktoberfest","laravel","linux","nginx","php","server","startup-script","vue"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dshoreman.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"dshoreman","issuehunt":null,"otechie":null,"custom":"paypal.me/dshoreman"}},"created_at":"2018-09-30T02:47:54.000Z","updated_at":"2023-03-22T22:51:46.426Z","dependencies_parsed_at":"2023-02-13T01:16:22.186Z","dependency_job_id":null,"html_url":"https://github.com/dshoreman/servidor","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/dshoreman/servidor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dshoreman%2Fservidor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dshoreman%2Fservidor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dshoreman%2Fservidor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dshoreman%2Fservidor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dshoreman","download_url":"https://codeload.github.com/dshoreman/servidor/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dshoreman%2Fservidor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338294,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["hacktoberfest","laravel","linux","nginx","php","server","startup-script","vue"],"created_at":"2026-01-12T10:27:48.373Z","updated_at":"2026-01-12T10:27:48.566Z","avatar_url":"https://github.com/dshoreman.png","language":"PHP","readme":"# Servidor\n\n[![GitHub release](https://img.shields.io/github/tag/dshoreman/servidor.svg?label=release)](https://github.com/dshoreman/servidor/releases)\n[![Build Status](https://github.com/dshoreman/servidor/workflows/build/badge.svg)](https://github.com/dshoreman/servidor/actions?query=workflow:build)\n[![codecov](https://codecov.io/gh/dshoreman/servidor/branch/develop/graph/badge.svg)](https://codecov.io/gh/dshoreman/servidor)\n[![Depfu](https://badges.depfu.com/badges/2c958ee33ec51367189f2762a8814dc5/count.svg)](https://depfu.com/github/dshoreman/servidor?project_id=5912)\n\nA modern web application for managing servers. Built on Laravel, using Semantic-UI-Vue for the frontend.\n\nServidor is still very much a work in progress, but what has been [added so far] is mostly functional.\n\n## Table of Contents\n\n* [Introduction]\n* [Installation]\n  * [Interactive Setup]\n  * [Cloud-init]\n* [Development]\n  * [Running Tests]\n* [Contributing]\n\n## What it Does\n\nCurrently there is basic support for projects and management of Linux users and groups. When you add a site, Servidor will\ntake care of cloning the repository, creating the relevant NginX configs and even reloading the web server. Starting in v0.5\nyou also have the ability to manually trigger a `git pull` on any given project without ever having to touch SSH.\n\n## Installation\n\n\u003e **NOTE: Servidor is still a work-in-progress!**  \n\u003e As such, there are some parts that likely aren't as secure as they could be, so  \n\u003e **exercise appropriate caution if you intend to use it on a public-facing server!**  \n\u003e If you find anything that can be improved, PRs are open and greatly appreciated.\n\n#### Interactive Setup\n\nTo install Servidor, first ensure you're logged in as root to a fresh server, then run the following in SSH:\n\n```sh\n# Save the installer first. Piping to Bash may lead to unexpected results in interactive mode\ncurl -sSL https://raw.githubusercontent.com/dshoreman/servidor/installer/setup.sh \u003e /tmp/setup \\\n  \u0026\u0026 bash /tmp/setup.sh\n```\n\nWhen Servidor has finished installing, you'll see the default login credentials with links to the Servidor backend below them.\nIn case you don't have DNS pointing at the server yet, both IP and hostname-based links are listed.\n\nRunning locally? Follow the [Development] instructions below to set up your local test environment.\n\n#### Cloud-init\n\nIf your server provider supports cloud-init scripts, you can run the installer automatically on first boot:\n\n```yaml\n#cloud-config\nruncmd:\n  - |\n    curl -sSL -o /tmp/setup-servidor.sh \\\n      https://github.com/dshoreman/servidor/releases/download/v0.16.1/setup.sh\n  - |\n    bash /tmp/setup-servidor.sh -v --branch master \\\n      --pusher 1234567:123abc45d67890e12f34:12345a6b7890c1defa2b\n```\n\nRemember to update the download link using the [latest version] from the [Releases] page.  \nAn example of [a basic cloud-init script] can be found in the wiki.\n\n## Development\n\nTo get started, run `make dev-env` in the project root. Servidor relies on [Vagrant] for development, so this command  \ntakes care of creating the VM, running the necessary prep, and installation of Servidor within the dev environment.  \nAfter the initial setup, standard Vagrant commands can be used to `up`, `suspend`, `reload` and so on.\n\n```sh\n# tl;dr:\ngit clone https://github.com/dshoreman/servidor.git\ncd servidor \u0026\u0026 make dev-env\n```\n\nDue to memory constraints within the VM, static assets are initially built during `make dev-env`.  \nTo recompile assets automatically when you make changes, run `npm run hot` or `npm run watch`.\n\n### Running Tests\n\n* **tl;dr:** *`make kitchen-sink`* (assuming vagrant is up)\n\nWith many tests relying on certain system utilities, it's best to run them in Vagrant as the web server user to avoid any issues.  \nTo run the PHPUnit tests, use `make test` which will automatically SSH into the Vagrant VM and run phpunit as www-data.\n\nOther make commands are available such as `make syntax` to run other CI tools. For a complete list, check the Makefile.\n\n## Contributing\n\nWhere possible, issues are grouped into one of various projects based on the page/section they apply to, so if you want to\nfind something to work on in a certain part of Servidor, then the Projects tab is a good place to start. Questions, bug reports,\nideas and PRs are all welcome and highly appreciated, so don't be afraid to ask if there's something you're not sure of!\n\n[Introduction]: #servidor\n[What it Does]: #what-it-does\n[added so far]: #what-it-does\n[Installation]: #installation\n[Interactive Setup]: #interactive-setup\n[latest version]: https://github.com/dshoreman/servidor/blob/master/bootstrap/app.php#L1-L5\n[Releases]: https://github.com/dshoreman/servidor/releases\n[a basic cloud-init script]: https://github.com/dshoreman/servidor/wiki/Example-Cloud-init-Script\n[Cloud-init]: #startup-script\n[Development]: #development\n[Running Tests]: #running-tests\n[Contributing]: #contributing\n[Vagrant]: https://vagrantup.com\n[vagrant-hostsupdater]: https://github.com/agiledivider/vagrant-hostsupdater#installation\n","funding_links":["https://liberapay.com/dshoreman","paypal.me/dshoreman"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdshoreman%2Fservidor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdshoreman%2Fservidor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdshoreman%2Fservidor/lists"}