{"id":49310492,"url":"https://github.com/ximtech/altium-migrator","last_synced_at":"2026-04-26T12:03:36.970Z","repository":{"id":132855953,"uuid":"582337564","full_name":"ximtech/altium-migrator","owner":"ximtech","description":"Spring boot application for automated Altium component migrations","archived":false,"fork":false,"pushed_at":"2024-02-01T14:16:34.000Z","size":379,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-30T16:51:52.936Z","etag":null,"topics":["altium-designer","migration-tool"],"latest_commit_sha":null,"homepage":"","language":"Groovy","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/ximtech.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}},"created_at":"2022-12-26T14:01:56.000Z","updated_at":"2024-03-07T11:07:04.000Z","dependencies_parsed_at":"2024-02-01T16:09:44.553Z","dependency_job_id":null,"html_url":"https://github.com/ximtech/altium-migrator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ximtech/altium-migrator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ximtech%2Faltium-migrator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ximtech%2Faltium-migrator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ximtech%2Faltium-migrator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ximtech%2Faltium-migrator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ximtech","download_url":"https://codeload.github.com/ximtech/altium-migrator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ximtech%2Faltium-migrator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32296259,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"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":["altium-designer","migration-tool"],"created_at":"2026-04-26T12:03:35.109Z","updated_at":"2026-04-26T12:03:36.958Z","avatar_url":"https://github.com/ximtech.png","language":"Groovy","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Altium database migration tool\n\n[![build](https://github.com/ximtech/altium-migrator/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/ximtech/altium-migrator/actions/workflows/build.yml)\n\nThe Altium database migration tool is a Spring boot application that helps handle changes from\n[Git component repository](https://github.com/ximtech/altium-library) to local database for offline development\nor any other hosted Postgres database by data source.\n\n\n### How it works\n\n![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/diagram.png)\n\n1. User run docker command, then if application image is not in local storage it will be downloaded from public docker hub\n2. The container will start with user provided DB connection or default for local development\n3. After the start, application will fetch from repository migration scripts(database sql dump)\n4. Then liquibase migration tool will check database state and update it if needed\n5. Application can be run as many times as needed, it won't overwrite data or duplicate them.\n\n\n### How to use it\n\n1. First, download and install Docker here: [Download Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)\n2. After Docker has been installed, check it with: `docker ps` in command prompt\n3. Then need to signup/sign-in for Docker hub. Open Docker desktop and then `Sign in`: \n\n![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/docker_config.png)\n\n4. Check login with command: `docker login`\n\n![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/docker_login.png)\n\n5. Now when Docker has configured. Need to install PostgresDB for local environment\n    - ***First option.*** Run Database in container see [here](https://hub.docker.com/_/postgres)\n      - Run in command line: `docker pull postgres`, it will pull the latest Postgres image\n      - Run Database image: \n      ```\n        docker run -d -p 5432:5432\\\n        --name dev-postgres \\\n        -e POSTGRES_PASSWORD=postgres \\\n        -e POSTGRES_USER=postgres \\\n        -e POSTGRES_DB=altium-components \\\n        postgres\n      ```\n    - ***Second option.*** Download and install Postgres for local development [here](https://www.postgresql.org/download/windows/) -\u003e `Download the installer`\n        - Download and install PgAdmin tool from [here](https://www.pgadmin.org/)\n        - Create empty Database: \n          - ![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/database.png)\n        - In `Database` field write: `altium-components` -\u003e `Save`\n        - Check that empty database has been created: \n          - ![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/empty_database.png)\n          \n6. ***Optionally:*** Create DB schema, or `altium` will be created as default schema. It will be used for all migrations\n7. When all has been configured and empty Database created. Then run application\n\n***Local development***\n``` text\ndocker run -p 5432:5432 -e PROFILE=docker-dev ximtech/altium-migrator\n```\n\n***Custom Database Hosting***\n\n***Note:*** For custom datasource do not change `PROFILE` variable\n\n```text\n    docker run -p 5432:5432 \\\n    -e PROFILE=prod \\\n    -e ALTIUM_DB_DATASOURCE='jdbc:postgresql://host.docker.internal:5432/altium-components' \\\n    -e ALTIUM_DB_USERNAME='postgres' \\\n    -e ALTIUM_DB_PASSWORD='postgres' \\\n    -e LIQUIBASE_SCHEMA_NAME=altium \\\n    ximtech/altium-migrator:latest\n```\n\n7. At the end check that all data has been transferred:\n- ![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/migration_finished.png)\n   \n***Database Structure***\n- ![\u003cimg width=\"20\" height=\"20\"/\u003e](assets/success.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fximtech%2Faltium-migrator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fximtech%2Faltium-migrator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fximtech%2Faltium-migrator/lists"}