{"id":13707115,"url":"https://github.com/cagedtornado/centralconfig","last_synced_at":"2025-04-23T15:42:38.449Z","repository":{"id":57525724,"uuid":"52555948","full_name":"cagedtornado/centralconfig","owner":"cagedtornado","description":"Simplified application configuration :wrench:","archived":false,"fork":false,"pushed_at":"2018-05-03T18:01:16.000Z","size":480,"stargazers_count":7,"open_issues_count":8,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-09T12:36:03.470Z","etag":null,"topics":["boltdb","config","configuration","configuration-management","configuration-service","docker","feature-flags","linux","macos","raspberry-pi","windows"],"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/cagedtornado.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":"2016-02-25T20:51:29.000Z","updated_at":"2021-09-24T18:27:21.000Z","dependencies_parsed_at":"2022-08-29T00:31:27.864Z","dependency_job_id":null,"html_url":"https://github.com/cagedtornado/centralconfig","commit_stats":null,"previous_names":["danesparza/centralconfig"],"tags_count":150,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagedtornado%2Fcentralconfig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagedtornado%2Fcentralconfig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagedtornado%2Fcentralconfig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagedtornado%2Fcentralconfig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cagedtornado","download_url":"https://codeload.github.com/cagedtornado/centralconfig/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250462555,"owners_count":21434610,"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":["boltdb","config","configuration","configuration-management","configuration-service","docker","feature-flags","linux","macos","raspberry-pi","windows"],"created_at":"2024-08-02T22:01:19.953Z","updated_at":"2025-04-23T15:42:38.431Z","avatar_url":"https://github.com/cagedtornado.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# centralconfig [![Circle CI](https://circleci.com/gh/cagedtornado/centralconfig.svg?style=shield)](https://circleci.com/gh/cagedtornado/centralconfig) [![Go Report Card](https://goreportcard.com/badge/github.com/cagedtornado/centralconfig)](https://goreportcard.com/report/github.com/cagedtornado/centralconfig) [![stable](http://badges.github.io/stability-badges/dist/stable.svg)](http://github.com/badges/stability-badges)\n\nA simple REST based service for managing application configuration across a cluster.  \nRuns natively on: Linux, [Windows](https://www.microsoft.com/en-us/windows), [OSX](http://www.apple.com/osx/), [FreeBSD](https://www.freebsd.org/), [NetBSD](https://www.netbsd.org/), [OpenBSD](http://www.openbsd.org/), and even [Raspberry Pi](https://www.raspberrypi.org/).\n\nStorage back-ends supported:\n- [BoltDB](https://github.com/boltdb/bolt) (default)\n- [MySQL](https://www.mysql.com/)\n- [Microsoft SQL server (MSSQL)](https://www.microsoft.com/en-us/server-cloud/products/sql-server/)\n\n### Quick start\nTo get up and running, [grab the latest release](https://github.com/danesparza/centralconfig/releases/latest) for your platform\n\nStart the server:\n```\ncentralconfig serve\n```\nThen visit the url [http://localhost:3000](http://localhost:3000) and you can add/edit your configuration through the built-in web interface.  \n\nIf no other configuration is specified, BoltDB will be used to store your config items in a file called 'config.db' in the working directory.\n\n### Docker quick start\nTo use the centralconfig docker image: \n\n[Install Docker](https://docs.docker.com/mac/started/)\n\nStart the server:\n```\ndocker run --restart=on-failure -d -p 3000:3000 cagedtornado/centralconfig:latest\n```\n\n### Configuration\nTo customize the config, first generate a default config file (with the name centralconfig.yaml):\n```\ncentralconfig defaults \u003e centralconfig.yaml\n```\n\n### Supported environment variables\nIf you're using centralconfig in as part of a [12 factors app](https://12factor.net/config) environment or just want to set centralconfig service settings through environment variables, you have the following settings available:\n\n| Command | Description |\n| --- | --- |\n| `SERVER.SSLCERT` | Path to the SSL certificate file |\n| `SERVER.SSLKEY` | Path to the SSL certificate key |\n| `DATASTORE.TYPE` | The type of backing storage for configuration.  One of: mysql, mssql, boltdb |\n| `DATASTORE.ADDRESS` | Location of the backing store |\n| `DATASTORE.DATABASE` | Database name to use in the backing store |\n| `DATASTORE.USER` | Databse user to use |\n| `DATASTORE.PASSWORD` | Database password to use |\n\n#### Example (with docker)\n```\ndocker run --restart=unless-stopped -d -p 3800:3000 -v /private/etc/ssl:/certs -e \"SERVER.SSLCERT=/certs/sslcert.pem\" -e \"SERVER.SSLKEY=/certs/sslcert.key\" -e \"DATASTORE.TYPE=mysql\" -e \"DATASTORE.ADDRESS=mysqldatabaseserver:3306\" -e \"DATASTORE.DATABASE=centralconfig\" -e \"DATASTORE.USER=myusername\" -e \"DATASTORE.PASSWORD=thepasswordhere\" cagedtornado/centralconfig:154\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcagedtornado%2Fcentralconfig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcagedtornado%2Fcentralconfig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcagedtornado%2Fcentralconfig/lists"}