> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/software-engineering-insights/use-software-engineering-insights/setup-sei/sei-ingestion-satellite/manage-satellite.md).

# Manage Satellite

Guide on how to download, install, and run the Ingestion Satellite container using Docker on any operating systems.

This page outlines the steps to update and manage the versions of the Ingestion Satellite using Docker and Kubernetes.

### Update the Satellite <a href="#update-the-satellite" id="update-the-satellite"></a>

Use these commands if you need to update the Ingestion Satellite version.

{% tabs %}
{% tab title="Docker" %}

```bash
# Pull latest version <a href="#pull-latest-version" id="pull-latest-version"></a>
docker pull levelops/ingestion-satellite

# List containers and find the current satellite ID <a href="#list-containers-and-find-the-current-satellite-id" id="list-containers-and-find-the-current-satellite-id"></a>
docker container ls

# Stop and remove the old container. Replace <ID> accordingly. <a href="#stop-and-remove-the-old-container-replace-lessidgreater-accordingly" id="stop-and-remove-the-old-container-replace-lessidgreater-accordingly"></a>
docker container stop <ID>
docker rm <ID>>

# Run the container again. It uses the latest version. Replace the local path accordingly. <a href="#run-the-container-again-it-uses-the-latest-version-replace-the-local-path-accordingly" id="run-the-container-again-it-uses-the-latest-version-replace-the-local-path-accordingly"></a>
docker run -v   /local/path/to/satellite.yml:/levelops/config.yml   -d levelops/ingestion-satellite
```

If you aren't able to execute the `docker pull` command, you can manually [download the Ingestion Satellite image](https://hub.docker.com/r/levelops/ingestion-satellite) from Docker Hub and install it.
{% endtab %}

{% tab title="Kubernetes" %}

```bash
# Find the name of the satellite deployment. <a href="#find-the-name-of-the-satellite-deployment" id="find-the-name-of-the-satellite-deployment"></a>
kubectl get deployments

# Restart the satellite deployment. <a href="#restart-the-satellite-deployment" id="restart-the-satellite-deployment"></a>
kubectl rollout restart deployment <deployment-name>
```

If you didn't change the default values in the template, the `deployment-name` is `levelops-satellite`, and you can use the following `restart` command:

```bash
kubectl rollout restart deployment levelops-satellite
```

{% endtab %}
{% endtabs %}

Keeping the Ingestion Satellite up-to-date ensures that you benefit from the latest features, improvements, and security patches.

{% @harness-feedback/feedback %}