{"id":36862663,"url":"https://github.com/gwaysys/supd","last_synced_at":"2026-01-12T14:51:17.972Z","repository":{"id":50066895,"uuid":"206083847","full_name":"gwaysys/supd","owner":"gwaysys","description":"supervisor like","archived":false,"fork":false,"pushed_at":"2025-12-18T09:58:59.000Z","size":861,"stargazers_count":8,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-21T17:11:12.280Z","etag":null,"topics":["go","golang","supervisor","supervisord"],"latest_commit_sha":null,"homepage":"","language":"Go","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/gwaysys.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-09-03T13:26:51.000Z","updated_at":"2025-12-18T09:59:03.000Z","dependencies_parsed_at":"2024-06-19T16:02:48.823Z","dependency_job_id":"f13d3879-e863-4f39-82e2-677e34b2a9c8","html_url":"https://github.com/gwaysys/supd","commit_stats":null,"previous_names":["gwaysys/supd","gwaycc/supd"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/gwaysys/supd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwaysys%2Fsupd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwaysys%2Fsupd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwaysys%2Fsupd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwaysys%2Fsupd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gwaysys","download_url":"https://codeload.github.com/gwaysys/supd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwaysys%2Fsupd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28340411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"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":["go","golang","supervisor","supervisord"],"created_at":"2026-01-12T14:51:17.167Z","updated_at":"2026-01-12T14:51:17.951Z","avatar_url":"https://github.com/gwaysys.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Install\n\n## Install from source\n\n```text\n# Need to install golang before building.\n\ngit clone https://github.com/gwaysys/supd.git\ncd supd\n./publish.sh\n./setup.sh install # ./setup.sh clean # to remove install\n\n# or \ncd publish/supd\n./setup.sh install\n```\n\n## Install from binary\n\nDownload binary package from https://github.com/gwaysys/supd/releases and decompress the package.\n\n```text\ncd supd\n./setup.sh install # ./setup.sh clean # to remove install\n```\n\n首先感谢原作者们的贡献, 以下是原项目文档，[ochinchina/supervisor](https://github.com/ochinchina/supervisord)。\n======================================================================================\n\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/ochinchina/supervisord)](https://goreportcard.com/report/github.com/ochinchina/supervisord)\n\n# Why this project?\n\nThe python script supervisord is a powerful tool used by a lot of guys to manage the processes. I like the tool supervisord also.\n\nBut this tool requires us to install the big python environment. In some situation, for example in the docker environment, the python is too big for us.\n\nIn this project, the supervisord is re-implemented in go-lang. The compiled supervisord is very suitable for these environment that the python is not installed.\n\n# Compile the supervisord\n\nBefore compiling the supervisord, make sure the go-lang is installed in your environement.\n\nTo compile the go-lang version supervisord, run following commands (required go 1.11+):\n\n1. local: `go build`\n1. linux: `env GOOS=linux GOARCH=amd64 go build -o supervisord_linux_amd64`\n\n# Run the supervisord\n\nAfter the supervisord binary is generated, create a supervisord configuration file and start the supervisord like below:\n\n```shell\n$ cat supervisor.conf\n[program:test]\ncommand = /your/program args\n$ supervisord -c supervisor.conf\n```\n# Run as daemon\nAdd the inet interface in your configuration:\n```ini\n[inet_http_server]\nport=127.0.0.1:9002\n```\nthen run\n```shell\n$ supervisord -c supervisor.conf -d\n```\nIn order to controll the daemon, you can use `$ supervisord ctl` subcommand, available commands are: `status`, `start`, `stop`, `shutdown`, `reload`.\n\n```shell\n$ supervisord ctl status\n$ supervisord ctl status program-1 program-2...\n$ supervisord ctl status group:*\n$ supervisord ctl stop program-1 program-2...\n$ supervisord ctl stop group:*\n$ supervisord ctl stop all\n$ supervisord ctl start program-1 program-2...\n$ supervisord ctl start group:*\n$ supervisord ctl start all\n$ supervisord ctl shutdown\n$ supervisord ctl reload\n$ supervisord ctl signal \u003csignal_name\u003e \u003cprocess_name\u003e \u003cprocess_name\u003e ...\n$ supervisord ctl signal all\n$ supervisord ctl pid \u003cprocess_name\u003e\n```\n\nthe URL of supervisord in the \"supervisor ctl\" subcommand is dected in following order:\n\n- check if option -s or --serverurl is present, use this url\n- check if -c option is present and the \"serverurl\" in \"supervisorctl\" section is present, use the \"serverurl\" in section \"supervisorctl\"\n- return http://localhost:9002\n\n# Check the version\n\ncommand \"version\" will show the current supervisor version.\n\n```shell\n$ supervisord version\n```\n\n# Supported features\n\n## http server\n\nthe unix socket \u0026 TCP http server is supported. Basic auth is supported.\n\nThe unix socket setting is in the \"unix_http_server\" section.\nThe TCP http server setting is in \"inet_http_server\" section.\n\nIf both \"inet_http_server\" and \"unix_http_server\" is not configured in the configuration file, no http server will be started.\n\n## supervisord information\n\nThe log \u0026 pid of supervisord process is supported by section \"supervisord\" setting.\n\n## program\n\nthe following features is supported in the \"program:x\" section:\n\n- program command\n- process name\n- numprocs\n- numprocs_start\n- autostart\n- startsecs\n- startretries\n- autorestart\n- exitcodes\n- stopsignal\n- stopwaitsecs\n- stdout_logfile\n- stdout_logfile_maxbytes\n- stdout_logfile_backups\n- redirect_stderr\n- stderr_logfile\n- stderr_logfile_maxbytes\n- stderr_logfile_backups\n- environment\n- priority\n- user\n- directory\n- stopasgroup\n- killasgroup\n- restartpause\n\n### program extends\n\nFollowing new keys are supported by the [program:xxx] section:\n\n- **depends_on**: define program depends information. If program A depends on program B, C, the program B, C will be started before program A. Example:\n\n```ini\n[program:A]\ndepends_on = B, C\n\n[program:B]\n...\n[program:C]\n...\n```\n\n- **user**: user in the section \"program:xxx\" now is extended to support group with format \"user[:group]\". So \"user\" can be configured as:\n\n```ini\n[program:xxx]\nuser = user_name\n...\n```\nor\n```ini\n[program:xxx]\nuser = user_name:group_name\n...\n```\n- **stopsignal** list\none or more stop signal can be configured. If more than one stopsignal is configured, when stoping the program, the supervisor will send the signals to the program one by one with interval \"stopwaitsecs\". If the program does not exit after all the signals sent to the program, the supervisor will kill the program\n\n- **restart_when_binary_changed**: a bool flag to control if the program should be restarted when the executable binary is changed\n\n- **restart_directory_monitor**: a path to be monitored for restarting purpose\n- **restart_file_pattern**: if a file is changed under restart_directory_monitor and the filename matches this pattern, the program will be restarted.\n\n## Group\nthe \"group\" section is supported and you can set \"programs\" item\n\n## Events\n\nthe supervisor 3.x defined events are supported partially. Now it supports following events:\n\n- all process state related events\n- process communication event\n- remote communication event\n- tick related events\n- process log related events\n\n## Logs\n\nThe logs ( field stdout_logfile, stderr_logfile ) from programs managed by the supervisord can be written to:\n\n```\n- /dev/null, ignore the log\n- /dev/stdout, write log to stdout\n- /dev/stderr, write log to stderr\n- syslog, write the log to local syslog\n- syslog @[protocol:]host[:port], write the log to remote syslog. protocol must be \"tcp\" or \"udp\", if missing, \"udp\" will be used. If port is missing, for \"udp\" protocol, it's value is 514 and for \"tcp\" protocol, it's value is 6514.\n- file name, write log to a file\n```\n\nMutiple log file can be configured for the stdout_logfile and stderr_logfile with delimeter ',', for example if want to a program write log to both stdout and test.log file, the stdout_logfile for the program can be configured as:\n\n```ini\nstdout_logfile = test.log, /dev/stdout\n```\n\n# Usage from a Docker container\n\nsupervisord is compiled inside a Docker image to be used directly inside another image, from the Docker Hub version.\n\n```Dockerfile\nFROM debian:latest\nCOPY --from=ochinchina/supervisord:latest /usr/local/bin/supervisord /usr/local/bin/supervisord\nCMD [\"/usr/local/bin/supervisord\"]\n```\n\n# The MIT License (MIT)\n\nCopyright (c) \u003cyear\u003e \u003ccopyright holders\u003e\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgwaysys%2Fsupd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgwaysys%2Fsupd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgwaysys%2Fsupd/lists"}