mirror of
				https://github.com/open-metadata/OpenMetadata.git
				synced 2025-11-04 04:29:13 +00:00 
			
		
		
		
	
		
			
	
	
		
			73 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
		
		
			
		
	
	
			73 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| 
								 | 
							
								---
							 | 
						||
| 
								 | 
							
								title: Upgrade on Docker
							 | 
						||
| 
								 | 
							
								slug: /deployment/upgrade/docker
							 | 
						||
| 
								 | 
							
								---
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Upgrade on Docker
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								To run OpenMetadata with Docker, you can simply download the `docker-compose.yml` file. Optionally, we added some
							 | 
						||
| 
								 | 
							
								Named Volumes to handle data persistence.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{% note %}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								You can find more details about Docker deployment [here](/deployment/docker)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{% /note %}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Below we have highlighted the steps needed to upgrade to the latest version with Docker. Make sure to also look [here](/deployment/upgrade/versions/100-to-110) for the specific details related to upgrading to 1.0.0
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{% partial file="/v1.4/deployment/upgrade/upgrade-prerequisites.md" /%}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Upgrade Process
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## Replace the docker compose file
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								- Stop the running compose deployment with below command 
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								docker compose down
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								- Download the Docker Compose Service File from OpenMetadata GitHub Release page [here](https://github.com/open-metadata/OpenMetadata/releases/latest)
							 | 
						||
| 
								 | 
							
								- Replace the existing Docker Compose Service File with the one downloaded from the above step
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{% note %}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Please make sure to go through [breaking changes and release highlights](/deployment/upgrade/versions/100-to-110).
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{% /note %}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								- Start the Docker Compose Service with the below command
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								docker compose -f docker-compose.yml up -d
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								{% partial file="/v1.4/deployment/upgrade/post-upgrade-steps.md" /%}
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Troubleshooting
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								#### Permission Denied when running  ```metadata openmetadata-imports-migration```
							 | 
						||
| 
								 | 
							
								If you have a `Permission Denied` error thrown when running ```metadata openmetadata-imports-migration --change-config-file-path``` you might need to change the permission on the `/opt/airflow/dags` folder. SSH into the ingestion container and check the permission on the folder running the below commands
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								ls -l /opt/airflow
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								ls -l /opt/airflow/dags
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								both the `dags` folder and the files inside `dags/` should have `airflow root` permission. if this is not the case simply run the below command
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								chown -R airflow:root /opt/airflow/dags
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								#### Broken DAGs can't load config file: Permission Denied
							 | 
						||
| 
								 | 
							
								You might need to change the permission on the `/opt/airflow/dag_generated_config` folder. SSH into the ingestion container and check the permission on the folder running the below commands
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								ls -l /opt/airflow
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								ls -l /opt/airflow/dag_generated_config
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								both the `dags` folder and the files inside `dags/` should have `airflow root` permission. if this is not the case simply run the below command
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								chown -R airflow:root /opt/airflow/dag_generated_config
							 | 
						||
| 
								 | 
							
								```
							 |