{"id":43448466,"url":"https://github.com/esign/ddev-import-remote-db","last_synced_at":"2026-02-10T08:04:46.685Z","repository":{"id":312843648,"uuid":"1046928858","full_name":"esign/ddev-import-remote-db","owner":"esign","description":"Import a remote MySQL database into your local DDEV database.","archived":false,"fork":false,"pushed_at":"2026-01-06T10:45:25.000Z","size":86,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-03T12:23:45.832Z","etag":null,"topics":["ddev-get"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/esign.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":"2025-08-29T13:06:22.000Z","updated_at":"2026-01-08T19:17:16.000Z","dependencies_parsed_at":"2025-09-02T11:27:35.239Z","dependency_job_id":"4d29c6a7-f2da-435e-a7aa-a31e0ed6150b","html_url":"https://github.com/esign/ddev-import-remote-db","commit_stats":null,"previous_names":["esign/ddev-import-remote-db"],"tags_count":4,"template":false,"template_full_name":"ddev/ddev-addon-template","purl":"pkg:github/esign/ddev-import-remote-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esign%2Fddev-import-remote-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esign%2Fddev-import-remote-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esign%2Fddev-import-remote-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esign%2Fddev-import-remote-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/esign","download_url":"https://codeload.github.com/esign/ddev-import-remote-db/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esign%2Fddev-import-remote-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29294405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T03:42:42.660Z","status":"ssl_error","status_checked_at":"2026-02-10T03:42:41.897Z","response_time":65,"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":["ddev-get"],"created_at":"2026-02-03T01:15:22.440Z","updated_at":"2026-02-10T08:04:46.504Z","avatar_url":"https://github.com/esign.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![add-on registry](https://img.shields.io/badge/DDEV-Add--on_Registry-blue)](https://addons.ddev.com)\n[![tests](https://github.com/esign/ddev-import-remote-db/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/esign/ddev-import-remote-db/actions/workflows/tests.yml?query=branch%3Amain)\n[![last commit](https://img.shields.io/github/last-commit/esign/ddev-import-remote-db)](https://github.com/esign/ddev-import-remote-db/commits)\n[![release](https://img.shields.io/github/v/release/esign/ddev-import-remote-db)](https://github.com/esign/ddev-import-remote-db/releases/latest)\n\n# DDEV Import Remote Db\n\n## Overview\n\nThis add-on allows you to import a remote MySQL database into your local [DDEV](https://ddev.com/) database.\nIt supports direct connections as well as SSH tunneling for secure access to remote databases.\n\n## Installation\n\n```bash\nddev add-on get esign/ddev-import-remote-db\nddev restart\n```\n\nAfter installation, make sure to commit the `.ddev` directory to version control.\n\n## Usage\n\n\n### Commands\n\n#### Import a remote MySQL database\n\n```bash\nddev import-remote-db --host \u003chost\u003e --user \u003cuser\u003e --database \u003cdatabase\u003e [--port \u003cport\u003e] [--ssh-host \u003cssh_host\u003e] [--ssh-user \u003cssh_user\u003e] [--password \u003cpassword\u003e]\n```\n\n**Flags:**\n\n| Flag | Description | Required |\n|------|-------------|----------|\n| `--host` | Remote MySQL host | Yes |\n| `--user` | MySQL username | Yes |\n| `--database` | Database name | Yes |\n| `--port` | MySQL port (default: 3306) | No |\n| `--ssh-host` | SSH host for tunneling | No |\n| `--ssh-user` | SSH username | No |\n| `--password` | MySQL password | No (will prompt if not provided) |\n\n**Example:**\n\n```bash\nddev import-remote-db --host db.example.com --user dbuser --database dbname --port 3307 --ssh-host ssh.example.com --ssh-user remoteuser --password mypass\n```\n\n#### Import a remote MySQL database using 1Password\n\n```bash\nddev import-remote-db-1pw \u003c1pw-item-uuid\u003e\n```\n\nThis command uses the [1Password CLI](https://developer.1password.com/docs/cli/get-started/) to securely fetch database credentials from your 1Password vault.\n\n**Steps:**\n1. You will be prompted for the 1Password item UUID (or you can pass it as an argument).\n2. The script will fetch the database credentials and (optionally) SSH details from the 1Password item.\n3. You will be asked if SSH is required. If so, you can provide SSH host/user if not present in the item.\n4. The script will run `ddev import-remote-db` with the fetched credentials.\n\n**1Password Item Fields:**\n\nThe script will look for the following fields in your 1Password item (it tries multiple field names for flexibility):\n\n| Purpose | Field Names (tries in order) | Required |\n|---------|------------------------------|----------|\n| Database Host | `host`, `server`, `DB_HOST` | Yes |\n| Database Username | `username`, `DB_USERNAME` | Yes |\n| Database Password | `password`, `DB_PASSWORD` | Yes |\n| Database Name | `database`, `DB_DATABASE` | Yes |\n| SSH Host | `SSH_HOST` | No (prompted if SSH required) |\n| SSH Username | `SSH_USER` | No (prompted if SSH required) |\n\n**Example:**\n\n```bash\nddev import-remote-db-1pw 0198f64f-5ac6-79a5-8238-750890b87ce5\n```\n\n**Note:** The 1Password CLI (`op`) must be installed and you must be signed in. The script will check for this and prompt you if not.\n\n---\n\n| Command | Description |\n| ------- | ----------- |\n| `ddev import-remote-db` | Import a remote MySQL database using direct or SSH connection |\n| `ddev import-remote-db-1pw` | Import a remote MySQL database using credentials from 1Password |\n| `ddev describe` | View service status and used ports for Import Remote Db |\n| `ddev logs -s import-remote-db` | Check Import Remote Db logs |\n\n## Advanced Customization\n\nTo change the Docker image:\n\n```bash\nddev dotenv set .ddev/.env.import-remote-db --import-remote-db-docker-image=\"ddev/ddev-utilities:latest\"\nddev add-on get esign/ddev-import-remote-db\nddev restart\n```\n\nMake sure to commit the `.ddev/.env.import-remote-db` file to version control.\n\nAll customization options (use with caution):\n\n| Variable | Flag | Default |\n| -------- | ---- | ------- |\n| `IMPORT_REMOTE_DB_DOCKER_IMAGE` | `--import-remote-db-docker-image` | `ddev/ddev-utilities:latest` |\n\n## Credits\n\n**Contributed and maintained by [@esign](https://github.com/esign)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesign%2Fddev-import-remote-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesign%2Fddev-import-remote-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesign%2Fddev-import-remote-db/lists"}