{"id":31542158,"url":"https://github.com/octopusnz/kentico-setup-macos","last_synced_at":"2026-05-04T13:34:10.312Z","repository":{"id":312195933,"uuid":"1046603037","full_name":"octopusnz/kentico-setup-macos","owner":"octopusnz","description":"Import a Kentico CMS database backup using Docker on macOS","archived":false,"fork":false,"pushed_at":"2025-09-03T03:02:21.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-04T11:42:31.936Z","etag":null,"topics":["docker","kentico","kentico-cms","macos","mssql","mssqldatabase","odbc","sqlpackage"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/octopusnz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2025-08-28T23:58:35.000Z","updated_at":"2025-08-31T01:42:06.000Z","dependencies_parsed_at":"2025-08-29T06:48:14.435Z","dependency_job_id":"e47e9f0e-ffd7-41af-bc33-208c9da81cbe","html_url":"https://github.com/octopusnz/kentico-setup-macos","commit_stats":null,"previous_names":["octopusnz/kentico-setup-macos"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/octopusnz/kentico-setup-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octopusnz%2Fkentico-setup-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octopusnz%2Fkentico-setup-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octopusnz%2Fkentico-setup-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octopusnz%2Fkentico-setup-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/octopusnz","download_url":"https://codeload.github.com/octopusnz/kentico-setup-macos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/octopusnz%2Fkentico-setup-macos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32609791,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"last_error":"SSL_read: 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":["docker","kentico","kentico-cms","macos","mssql","mssqldatabase","odbc","sqlpackage"],"created_at":"2025-10-04T11:31:25.846Z","updated_at":"2026-05-04T13:34:10.307Z","avatar_url":"https://github.com/octopusnz.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Kentico using Docker for macOS.\n\nThis project provides a generic workflow to set up a local Kentico database using Docker, Microsoft SQL Server, and a Kentico database backup (bacpac file).\n\nWe have only tested this on macOS Sequoia 15.6.* with an Apple M1 (ARM) Processor.\nIt hopefully works on Intel and other macOS versions but may require some tweaks.\nIf you do run into issues feel free to submit a pull request with any updates and include the OS version and CPU type you've tested it on.\n\nThis uses a local copy of sqlpackage rather than trying to get it working in Docker.\nThe scripts will automatically install the following things as needed:\n\n1. sqlpackage from Microsoft into a sqlpackage/ folder in your project directory.\n  https://learn.microsoft.com/en-us/sql/tools/sqlpackage/sqlpackage\n\n2. unixODBC, Microsoft ODBC Driver 18 for SQL Server, and mssql-tools\n  https://formulae.brew.sh/formula/unixodbc. \n  https://github.com/Microsoft/homebrew-mssql-release. \n\n3. Rosetta (if your CPU is ARM) due to the local sqlpackage being an amd-64 binary.\n  https://support.apple.com/en-nz/102527\n\n## Prerequisites\n1. Docker Desktop running\n  https://www.docker.com/products/docker-desktop/\n\n2. Homebrew (for ODBC driver install)\n  https://brew.sh/\n\n3. Make if you wish to use the Makefile for convenience.\n  Part of the Xcode command line tools:\n  https://developer.apple.com/xcode/resources/\n\n## Quick Start\n```bash\n#1. Make scripts executable\nchmod +x scripts/*.sh\n\n#2. Install sqlpackage locally\n./scripts/get_sqlpackage.sh\n\n#3. Install mssql-tools, unixODBC, and Microsoft ODBC Driver\n./scripts/setup_odbc_mac.sh \n\n#4. Launch Docker Desktop. Spotlight: \"Docker\" or run: \nopen -a Docker\n# If your CPU is ARM - Double check under [Settings] -\u003e [General] -\u003e Scroll to \n# [Virtual Machine Options]. Ensure [Apple Virtualization Framework] is selected and \n# under that [Use Rosetta for emulation] is enabled.\n\n# 5. Start SQL Server locally\n./scripts/start_sqlserver.sh\n\n# 6. Import your bacpac into a new DB\n./scripts/import_bacpac_local.sh YourBackup.bacpac KenticoLocal\n\n# 7. Verify everything is working \n  docker exec -it mssql-kentico /opt/mssql-tools18/bin/sqlcmd \\\n    -S localhost -U sa -P 'YourStrong!Passw0rd' -C -Q \"SELECT name FROM sys.databases;\"\n\n```\n## Key Files / Scripts\n- `YourBackup.bacpac` (your Kentico database backup)\n- `scripts/start_sqlserver.sh` (start SQL Server container)\n- `scripts/import_bacpac_local.sh` (import bacpac using local sqlpackage binary)\n- `scripts/get_sqlpackage.sh` (download sqlpackage for macOS)\n- `scripts/teardown_sqlserver.sh` (stop/remove SQL Server container)\n- `scripts/setup_odbc_mac.sh` (install unixODBC using brew install)\n\n## Update Makefile Variables\nBefore running the Makefile targets, you may want to update the following variables in the `Makefile` to match your environment:\n\n- `BACPAC` – the path or filename of your Kentico database backup (default: `YourBackup.bacpac`)\n- `DB` – the name of the database to create/import (default: `KenticoLocal`)\n- `SA_PASSWORD` – the SQL Server system administrator password (default: `YourStrong!Passw0rd`)\n- `CONTAINER` – the name for the SQL Server Docker container (default: `mssql-kentico`)\n- `SERVER` – the SQL Server host and port (default: `host.docker.internal,1433`)\n\nYou can edit these directly in the `Makefile`, or override them at runtime:\n\n```bash\nmake import BACPAC=MyBackup.bacpac DB=MyKenticoDB SA_PASSWORD='MyPassword123!'\n```\n\nHow It Works\n------------\n1. SQL Server runs locally in Docker: `mcr.microsoft.com/mssql/server:2022-latest`.\n2. Bacpac database backup is imported via the local sqlpackage install.\n3. Database queries using mssql-tools (sqlcmd) for example:\n\nStart an interactive session (run SQL commands like SELECT * FROM sys.tables;)\n  `docker exec -it mssql-kentico /opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P 'YourStrong!Passw0rd' -d KenticoLocal`\n\nRun a one-off query and return results:\n`docker exec -it mssql-kentico /opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P 'YourStrong!Passw0rd' -d KenticoLocal -Q \"SELECT TOP 10 * FROM CMS_User;\"`\n\nApple Silicon (arm64) Notes\n---------------------------\nThe official `mcr.microsoft.com/mssql/server` image is amd64-only. \n\nRun Docker Desktop: It transparently emulates amd64. \n  Just run `make start`.\n\nmacOS should prompt to install Rosetta when you install or run sqlinstance but if not you can run:\n`softwareupdate --install-rosetta --agree-to-license`\n\nmacOS ODBC\n----------\nRun the helper script (installs unixODBC + msodbcsql18 + mssql-tools18):\n```bash\nscripts/setup_odbc_mac.sh\n```\nManual install:\n```bash\nbrew install unixodbc\nbrew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release ACCEPT_EULA=Y \nbrew install msodbcsql18 mssql-tools18\n```\nVerify driver:\n```bash\nodbcinst -q -d | grep 'ODBC Driver 18'\n```\n\nsqlpackage (Import Tool)\n-------------------------\nTo install sqlpackage, use one of the following options:\n\nAutomatically:\n```bash\nscripts/get_sqlpackage.sh\n```\nThis script will download and unpack the latest sqlpackage tool for macOS into `./sqlpackage/`.\n\nManual install:\n1. Download the macOS (Intel) sqlpackage zip from Microsoft Docs: \nhttps://learn.microsoft.com/en-us/sql/tools/sqlpackage-download\n2. Unzip into `./sqlpackage/` so the binary is at `./sqlpackage/sqlpackage`.\n3. Use the import script as normal.\n\nApple silicon requires Rosetta (for Intel binaries). macOS should prompt to install it, but if not you can run: `softwareupdate --install-rosetta --agree-to-license`\n\nExample Make Targets \u0026 Shortcuts\n--------------------------------\n```\nmake start                # start container\nmake import-local         # local sqlpackage import\nmake sqlcmd               # interactive sqlcmd to $(DB)\nmake help                 # list all targets\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctopusnz%2Fkentico-setup-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foctopusnz%2Fkentico-setup-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctopusnz%2Fkentico-setup-macos/lists"}