[{"_1":2,"_188":-5,"_189":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_163":164},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":85,"_106":107,"_154":-5,"_155":11,"_156":17,"_157":11,"_158":-5,"_159":11,"_160":-5,"_161":162},"canonicalUrl","https://hub.docker.com/r/vertigo/konga/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","vertigo","reponame","konga","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2020-05-19T23:57:09.785185Z","description","","is_private","last_updated","2020-06-03T21:47:38.54928Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",401,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","## More than just another GUI to [KONG Admin API](http://getkong.org) [![Build Status](https://travis-ci.org/pantsel/konga.svg?branch=master)](https://travis-ci.org/pantsel/konga) [![Gitter chat](https://badges.gitter.im/pantsel-konga/Lobby.png)](https://gitter.im/pantsel-konga/Lobby)\n\n\n[![Dashboard](screenshots/bc3.png)](https://raw.githubusercontent.com/pantsel/konga/master/screenshots/bc2.png)\n\n_Konga is not an official app. No affiliation with [Kong](https://www.konghq.com/)._\n\n### Support the project\nIf you find Konga helpful, \nyou can show your support and help me continue maintaining the project by [buying me a coffee](buymeacoff.ee/F1aRIj8CG)\nor becoming a [Patron](https://www.patreon.com/kongaui). Cheers!\n\n $\"Buy$ \n\n\n## Supported by\n\nSpecial thanks to our supporters that help us keep the project going and the motivation alive.\n\n

\n\n## Summary\n\n- [**Discussions & Support**](#discussions--support)\n- [**Features**](#features)\n- [**Compatibility**](#compatibility)\n- [**Prerequisites**](#prerequisites)\n- [**Used libraries**](#used-libraries)\n- [**Installation**](#installation)\n- [**Configuration**](#configuration)\n- [**Environment variables**](#environment-variables)\n- [**Running Konga**](#running-konga)\n- [**Upgrading**](#upgrading)\n- [**FAQ**](#faq)\n- [**More Kong related stuff**](#more-kong-related-stuff)\n- [**License**](#license)\n\n## Discussions & Support\nIf you need to discuss anything Konga related, we have a chatroom on Gitter:\n\n[![Gitter chat](https://badges.gitter.im/pantsel-konga/Lobby.png)](https://gitter.im/pantsel-konga/Lobby)\n\n## Features\n* Manage all Kong Admin API Objects.\n* Import Consumers from remote sources (Databases, files, APIs etc.).\n* Manage multiple Kong Nodes.\n* Backup, restore and migrate Kong Nodes using Snapshots.\n* Monitor Node and API states using health checks.\n* Email & Slack notifications.\n* Multiple users.\n* Easy database integration (MySQL, postgresSQL, MongoDB).\n\n## Compatibility\n**From 0.14.0 onwards, Konga is ONLY compatible with Kong 1.x**\n\nIf you're on an older Kong version , use [this](https://github.com/pantsel/konga/tree/legacy) branch \nor `konga:legacy` from docker hub instead.\n\n## Prerequisites\n- A running [Kong installation](https://getkong.org/) \n- Nodejs >= 8, <= 12.x (12.16 LTS is recommended)\n- Npm\n\n## Used libraries\n* Sails.js, http://sailsjs.org/\n* AngularJS, https://angularjs.org/\n\n## Installation\n\nInstall `npm` and `node.js`. Instructions can be found [here](http://sailsjs.org/#/getStarted?q=what-os-do-i-need).\n\nInstall `bower`, ad `gulp` packages.\n```\n$ git clone https://github.com/pantsel/konga.git\n$ cd konga\n$ npm i\n```\n\n## Configuration\nYou can configure your application to use your environment specified\nsettings.\n\nThere is an example configuration file on the root folder.\n\n```\n.env_example\n```\n\nJust copy this to `.env` and make necessary changes to it. Note that this\n`.env` file is in .gitignore so it won't go to VCS at any point.\n\n## Environment variables\nThese are the general environment variables Konga uses.\n\n| VAR | DESCRIPTION | VALUES | DEFAULT |\n|--------------------|----------------------------------------------------------------------------------------------------------------------------|----------------------------------------|----------------------------------------------|\n| HOST | The IP address that will be bind by Konga's server | - | '0.0.0.0' |\n| PORT | The port that will be used by Konga's server | - | 1337 |\n| NODE_ENV | The environment | `production`,`development` | `development` |\n| SSL_KEY_PATH | If you want to use SSL, this will be the absolute path to the .key file. Both `SSL_KEY_PATH` & `SSL_CRT_PATH` must be set. | - | null |\n| SSL_CRT_PATH | If you want to use SSL, this will be the absolute path to the .crt file. Both `SSL_KEY_PATH` & `SSL_CRT_PATH` must be set. | - | null |\n| KONGA_HOOK_TIMEOUT | The time in ms that Konga will wait for startup tasks to finish before exiting the process. | - | 60000 |\n| DB_ADAPTER | The database that Konga will use. If not set, the localDisk db will be used. | `mongo`,`mysql`,`postgres` | - |\n| DB_URI | The full db connection string. Depends on `DB_ADAPTER`. If this is set, no other DB related var is needed. | - | - |\n| DB_HOST | If `DB_URI` is not specified, this is the database host. Depends on `DB_ADAPTER`. | - | localhost |\n| DB_PORT | If `DB_URI` is not specified, this is the database port. Depends on `DB_ADAPTER`. | - | DB default. |\n| DB_USER | If `DB_URI` is not specified, this is the database user. Depends on `DB_ADAPTER`. | - | - |\n| DB_PASSWORD | If `DB_URI` is not specified, this is the database user's password. Depends on `DB_ADAPTER`. | - | - |\n| DB_DATABASE | If `DB_URI` is not specified, this is the name of Konga's db. Depends on `DB_ADAPTER`. | - | `konga_database` |\n| DB_PG_SCHEMA | If using postgres as a database, this is the schema that will be used. | - | `public` |\n| KONGA_LOG_LEVEL | The logging level | `silly`,`debug`,`info`,`warn`,`error` | `debug` on dev environment & `warn` on prod. |\n| TOKEN_SECRET | The secret that will be used to sign JWT tokens issued by Konga | - | - |\n| NO_AUTH | Run Konga without Authentication | true/false | - |\n| BASE_URL | Define a base URL or relative path that Konga will be loaded from. Ex: www.example.com/konga | | - |\n| KONGA_SEED_USER_DATA_SOURCE_FILE | Seed default users on first run. [Docs](./docs/SEED_DEFAULT_DATA.md). | | - |\n| KONGA_SEED_KONG_NODE_DATA_SOURCE_FILE | Seed default Kong Admin API connections on first run [Docs](./docs/SEED_DEFAULT_DATA.md) | | - |\n\n\n### Databases Integration\n\nKonga is bundled with It's own persistence mechanism for storing users and configuration.\n\nA local persistent object store is used by default, which works great as a bundled, starter database (with the strict caveat that it is for non-production use only).\n\nThe application also supports some of the most popular databases out of the box:\n\n1. MySQL\n2. MongoDB\n3. PostgresSQL\n\nIn order to use them, set the appropriate env vars in your `.env` file.\n \n\n## Running Konga\n\n### Development\n```\n$ npm start\n```\nKonga GUI will be available at `http://localhost:1337`\n\n### Production\n\n***************************************************************************************** \nIn case of `MySQL` or `PostgresSQL` adapters, Konga will not perform db migrations when running in production mode.\n\nYou can manually perform the migrations by calling ```$ node ./bin/konga.js prepare``` \n, passing the args needed for the database connectivity.\n\nFor example: \n\n```\n$ node ./bin/konga.js prepare --adapter postgres --uri postgresql://localhost:5432/konga\n```\nThe process will exit after all migrations are completed. \n\n*****************************************************************************************\n\nFinally:\n```\n$ npm run production\n```\nKonga GUI will be available at `http://localhost:1337`\n\n\n### Production Docker Image\n\nThe following instructions assume that you have a running Kong instance following the\ninstructions from [Kong's docker hub](https://hub.docker.com/_/kong/)\n```\n$ docker pull pantsel/konga\n$ docker run -p 1337:1337 \\\n --network {{kong-network}} \\ // optional\n --name konga \\\n -e \"NODE_ENV=production\" \\ // or \"development\" | defaults to 'development'\n -e \"TOKEN_SECRET={{somerandomstring}}\" \\\n pantsel/konga\n```\n\n#### To use one of the supported databases\n\n1. ##### Prepare the database\n> **Note**: You can skip this step if using the `mongo` adapter.\n\nYou can prepare the database using an ephemeral container that runs the prepare command.\n\n**Args**\n\nargument | description | default\n----------|-------------|--------\n-c | command | -\n-a | adapter (can be `postgres` or `mysql`) | -\n-u | full database connection url | -\n\n```\n$ docker run --rm pantsel/konga:latest -c prepare -a {{adapter}} -u {{connection-uri}}\n```\n\n\n2. ##### Start Konga\n```\n$ docker run -p 1337:1337 \n --network {{kong-network}} \\ // optional\n -e \"TOKEN_SECRET={{somerandomstring}}\" \\\n -e \"DB_ADAPTER=the-name-of-the-adapter\" \\ // 'mongo','postgres','sqlserver' or 'mysql'\n -e \"DB_HOST=your-db-hostname\" \\\n -e \"DB_PORT=your-db-port\" \\ // Defaults to the default db port\n -e \"DB_USER=your-db-user\" \\ // Omit if not relevant\n -e \"DB_PASSWORD=your-db-password\" \\ // Omit if not relevant\n -e \"DB_DATABASE=your-db-name\" \\ // Defaults to 'konga_database'\n -e \"DB_PG_SCHEMA=my-schema\"\\ // Optionally define a schema when integrating with prostgres\n -e \"NODE_ENV=production\" \\ // or 'development' | defaults to 'development'\n --name konga \\\n pantsel/konga\n \n \n // Alternatively you can use the full connection string to connect to a database\n $ docker run -p 1337:1337 \n --network {{kong-network}} \\ // optional\n -e \"TOKEN_SECRET={{somerandomstring}}\" \\\n -e \"DB_ADAPTER=the-name-of-the-adapter\" \\ // 'mongo','postgres','sqlserver' or 'mysql'\n -e \"DB_URI=full-connection-uri\" \\\n -e \"NODE_ENV=production\" \\ // or 'development' | defaults to 'development'\n --name konga \\\n pantsel/konga\n```\n\n\nThe GUI will be available at `http://{your server's public ip}:1337`\n\n\n[It is possible to seed default users on first install.](./docs/SEED_DEFAULT_DATA.md)\n\nYou may also configure Konga to authenticate via [LDAP](./docs/LDAP.md).\n\n\n## Upgrading\nIn some cases a newer version of Konga may introduce changes in database schemas.\nThe only thing you need to do is to start Konga in dev mode once so that the migrations will be applied.\nThen stop the app and run it again in production mode.\n\nif you're using docker, you can lift an ephemeral container, as stated before:\n```\n$ docker run --rm pantsel/konga:latest -c prepare -a {{adapter}} -u {{connection-uri}}\n```\n\n## FAQ\n\n##### 1. Getting blank page with `Uncaught ReferenceError: angular is not defined`\n\nIn some cases when running `npm install`, the bower dependencies are not installed properly.\nYou will need to cd into your project's root directory and install them manually by typing\n```\n$ npm run bower-deps\n```\n\n##### 2. Can't add/edit some plugin properties.\nWhen a plugin property is an array, the input is handled by a chip component.\nYou will need to press `enter` after every value you type in\nso that the component assigns it to an array index.\nSee issue [#48](https://github.com/pantsel/konga/issues/48) for reference.\n\n##### 3. EACCES permission denied, mkdir '/kongadata/'.\nIf you see this error while trying to run Konga, it means that konga has no write permissions to\nit's default data dir `/kongadata`. You will just have to define the storage path yourself to \na directory Konga will have access permissions via the env var `STORAGE_PATH`.\n\n##### 4. The hook `grunt` is taking too long to load\nThe default timeout for the sails hooks to load is 60000. In some cases, depending on\nthe memory the host machine has available, startup tasks like code minification and uglyfication\nmay take longer to complete. You can fix that by setting then env var `KONGA_HOOK_TIMEOUT` to something\ngreater than 60000, like 120000.\n\n\n## More Kong related stuff\n- [**Kong Admin proxy**](https://github.com/pantsel/kong-admin-proxy)\n- [**Kong Middleman plugin**](https://github.com/pantsel/kong-middleman-plugin)\n\n## Author\n\nPanagis Tselentis\n\n## License\n```\nThe MIT License (MIT)\n=====================\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.\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",494276837,"orgData",{"_86":87,"_88":89,"_90":91,"_92":29,"_93":44,"_94":95,"_96":97,"_98":99,"_100":101,"_102":44,"_103":44,"_104":44,"_105":17},"id","5bcddf9f2abe4226b412b52c08999ee2","uuid","5bcddf9f-2abe-4226-b412-b52c08999ee2","type","organization","orgname","full_name","location","Brazil","company","Vertigo Tecnologia","profile_url","http://www.vertigo.com.br/","date_joined","2014-12-29T16:43:18.952968Z","gravatar_url","gravatar_email","badge","is_active","recentTags",[108,144],{"_109":40,"_110":111,"_112":113,"_86":114,"_115":116,"_46":133,"_134":111,"_135":29,"_136":52,"_53":137,"_138":139,"_140":124,"_141":133,"_142":62,"_143":17},"content_type","creator",178689,"full_size",146164789,101141124,"images",[117],{"_118":119,"_120":121,"_122":44,"_123":124,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":113,"_59":62,"_132":-5},"architecture","amd64","digest","sha256:481072cc62499e9d67f47e858cf09173fe276cc650efaeb3395087e620342331","features","last_pulled","2026-09-23T05:34:19.261408884Z","last_pushed","2020-06-03T21:47:36Z","os","linux","os_features","os_version","size","variant","2020-06-03T21:47:35.710572Z","last_updater","last_updater_username","media_type","latest","repository",9076891,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_109":40,"_110":111,"_112":145,"_86":146,"_115":147,"_46":152,"_134":111,"_135":29,"_136":52,"_53":153,"_138":139,"_140":150,"_141":152,"_142":62,"_143":17},145705261,101136284,[148],{"_118":119,"_120":149,"_122":44,"_123":150,"_125":151,"_127":128,"_129":44,"_130":-5,"_131":145,"_59":62,"_132":-5},"sha256:412d3b0b7c9ebc4395bc17d9666d9c04c89aa22db58241fdb8c6370e4d8cda0d","2026-09-19T00:36:06.449425217Z","2020-05-20T00:08:51Z","2020-05-20T00:08:50.754901Z","brand","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":165,"_172":173,"_161":186,"_187":11},{"_36":166,"_38":167,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":168,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":169,"_75":11,"_76":171,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":170},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_174":175,"_176":-5,"_177":-5,"_178":179},"count",2,"next","previous","results",[180,183],{"_109":40,"_110":111,"_112":113,"_86":114,"_115":181,"_46":133,"_134":111,"_135":29,"_136":52,"_53":137,"_138":139,"_140":124,"_141":133,"_142":62,"_143":17},[182],{"_118":119,"_120":121,"_122":44,"_123":124,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":113,"_59":62,"_132":-5},{"_109":40,"_110":111,"_112":145,"_86":146,"_115":184,"_46":152,"_134":111,"_135":29,"_136":52,"_53":153,"_138":139,"_140":150,"_141":152,"_142":62,"_143":17},[185],{"_118":119,"_120":149,"_122":44,"_123":150,"_125":151,"_127":128,"_129":44,"_130":-5,"_131":145,"_59":62,"_132":-5},[],"canDeleteTags","actionData","errors"]

vertigo/konga

Tags for vertigo/konga