# How to import configuration into kong cluster using deck **URL:** \ **Category:** General\ **Created:** [July 29, 2019, 4:35pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103 "2019-07-29T16:35:43Z")\ **Posts on this page:** 14\ **Page:** 1
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [July 29, 2019, 4:35pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/1 "2019-07-29T16:35:43Z")
I can see deck dump that dumps all the configurations in the yaml file, but I dont see any deck import. Can you please guide me how to use deck to import configurations into kong with preserving what is already deployed in the kong cluster. ---
**Author:** ![hbagdi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hbagdi/32/562_2.png) [@hbagdi](https://discuss.konghq.com/u/hbagdi)\ **Post date:** [July 29, 2019, 8:22pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/2 "2019-07-29T20:22:43Z")
You can use `deck diff` and `deck sync` commands to import the configuration into Kong. These commands will tell you the difference in the state of the configuration between the database and the config file and apply those changes. ---
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [July 30, 2019, 12:53am UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/3 "2019-07-30T00:53:06Z")
Thanks for replying. I noticed that when I did deck diff it said that it will delete the existing configuration in the db and create all the configuration in the yaml file. I don’t want this behaviour. What I need is to leave alone what is in the db and only add new configuration from the yaml file. Is this behaviour possible? It appears deck will delete everything that is present in the db and then recreate all configurations from the yaml file. Please confirm ---
**Author:** ![hbagdi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hbagdi/32/562_2.png) [@hbagdi](https://discuss.konghq.com/u/hbagdi)\ **Post date:** [July 30, 2019, 5:45pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/4 "2019-07-30T17:45:12Z")
You have two options: - You can use `deck dump` to export what is present in the DB. Then add your new configuration in the newly generated config file. Then `deck diff` will only add the new configuration without deleting the existing one. - If you are using Kong 1.1 or later, you can use `select_tags` functionality, which will leave all the existing configuration as is and only create the configuration you specify via the YAML file. ---
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [July 30, 2019, 7:22pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/5 "2019-07-30T19:22:14Z")
Thank you Harry appreciate it. we are enterprise 0.35-1 customer, does both options are available to us? ---
**Author:** ![hbagdi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hbagdi/32/562_2.png) [@hbagdi](https://discuss.konghq.com/u/hbagdi)\ **Post date:** [July 31, 2019, 3:00pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/6 "2019-07-31T15:00:37Z")
> [@sid](#): > > we are enterprise 0.35-1 customer, does both options are available to us? The second option will be available to you in Kong Enterprise 0.36. Since you are an Enterprise customer, you have another option: You can use workspaces. You can leave the existing configuration in the default workspace. You can then create a new workspace and then point decK to use the new workspace. decK will then manage configuration for the specific workspace only. ---
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [July 31, 2019, 6:42pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/7 "2019-07-31T18:42:12Z")
so you are suggesting rather than doing diff between db and yaml file, just create a new workspace and then import the new configuration in the new workspace. so for example we create a workspace1 then we import the configuration file in ws1 this way we keep creating new workspaces and import the configurations in that ---
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [July 31, 2019, 7:29pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/8 "2019-07-31T19:29:30Z")
by the way I followed first option which is diff first and I saw following creating service bbbb creating service xxxx creating service rrrr creating route PolicyServiceRoutes creating route rrrr creating route rrrrrr creating plugin rate-limiting-advanced on service fffff creating plugin rate-limiting-advanced on service 3333 creating plugin rate-limiting-advanced on service 55555 deleting plugin rate-limiting-advanced on service zaaaaaa deleting route ccc deleting route 4444-service-route deleting service xxxxxx deleting service rrrrr Then when I did deck sync, it deleted everything I had in the db and recreated everything from the yaml file. This is not what I wanted I just wanted it to update incrementally not remove existing stuff. Not good at all ---
**Author:** ![hbagdi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hbagdi/32/562_2.png) [@hbagdi](https://discuss.konghq.com/u/hbagdi)\ **Post date:** [August 1, 2019, 3:51pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/9 "2019-08-01T15:51:44Z")
> [@sid](#): > > Then when I did deck sync, it deleted everything I had in the db and recreated everything from the yaml file. This is not what I wanted I just wanted it to update incrementally not remove existing stuff. Not good at all Not sure what you are doing here but this is what works: ```auto deck dump # this creates a kong.yaml file with all your DB configuration in it # edit the file to add your service and route and whatever else you need deck diff # this will show only the entities you are creating deck sync # this will actually apply the diff ``` ---
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [August 1, 2019, 8:06pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/10 "2019-08-01T20:06:36Z")
Thanks, I did the following deck dump # I did this in a lower environment and created kong.yaml Then I copied the above generated yaml file to the uat environment deck diff This showed that it was creating everything coming over from dev environment and deleting everything in the new uat environment deck sync It created all the services that came in the kong.yaml from dev but deleting everything that was present in the db ---
**Author:** ![hbagdi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hbagdi/32/562_2.png) [@hbagdi](https://discuss.konghq.com/u/hbagdi)\ **Post date:** [August 1, 2019, 11:04pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/11 "2019-08-01T23:04:39Z")
That sounds right. One obvious thing that I forgot to mention is that apply it against the same database. If you want to combine the configuration of two different envs, then dump those configurations, merge them and then apply. Your YAML file is the source of truth. Whatever the configuration of Kong should look like, should be present in the YAML file. ---
**Author:** ![sid](https://avatars.discourse-cdn.com/v4/letter/s/5f9b8f/32.png) [@sid](https://discuss.konghq.com/u/sid)\ **Post date:** [August 1, 2019, 11:57pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/12 "2019-08-01T23:57:42Z")
ah that explains the behavior πŸ™‚ . Since in my case yaml file came from dev environment it became the source of truth compared to the db in the uat environment. This, when I did the sync it basically deleted what was in the db and created everything in the yaml file. so like you said dump from each environment need to be merged , resolved and then synced in the target environment otherwise there could be an issue. Can we document this so no one else has a problem πŸ™‚ ---
**Author:** ![hbagdi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/hbagdi/32/562_2.png) [@hbagdi](https://discuss.konghq.com/u/hbagdi)\ **Post date:** [August 5, 2019, 7:04pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/13 "2019-08-05T19:04:50Z")
> [@sid](#): > > Can we document this so no one else has a problem πŸ™‚ This should be obvious but if it not, I’d welcome a PR welcome! ---
**Author:** ![Sachin\_Ghumbre](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.konghq.com/sachin_ghumbre/32/2737_2.png) [@Sachin\_Ghumbre](https://discuss.konghq.com/u/Sachin_Ghumbre)\ **Post date:** [December 21, 2021, 1:07pm UTC](https://discuss.konghq.com/t/how-to-import-configuration-into-kong-cluster-using-deck/4103/15 "2021-12-21T13:07:40Z")
> [@hbagdi](#): > > This should be obvious but if it not, I’d welcome a PR welcome! Is this documented ? If yes, please share the link