---
orphan: true
---

# How-to guides

Practical guides for common tasks and problems.

::::{grid} 1 1 2 2
:gutter: 3

:::{grid-item-card} {octicon}`tools` Troubleshooting
:link: troubleshooting
:link-type: doc

Common issues and how to fix them.
:::

:::{grid-item-card} {octicon}`checklist` Diagnose and repair
:link: diagnose-and-repair
:link-type: doc

Use status output, cache repair, shell checks, and issue details to debug problems.
:::

:::{grid-item-card} {octicon}`terminal` Nonstandard shell startup
:link: nonstandard-shell-startup
:link-type: doc

Install hooks in custom RC files, IDE shells, PowerShell profiles, and fish files.
:::

:::{grid-item-card} {octicon}`server` Remote and automated environments
:link: remote-and-automated-environments
:link-type: doc

IDE terminals, remote development, Docker, dev containers, and CI.
:::

:::{grid-item-card} {octicon}`lock` Offline and restricted networks
:link: offline-and-restricted-networks
:link-type: doc

Generate metadata for air-gapped machines, private mirrors, containers, and CI.
:::

:::{grid-item-card} {octicon}`plug` Plugin completions
:link: custom-completions
:link-type: doc

Making your conda plugin work well with the completion system.
:::

:::{grid-item-card} {octicon}`database` Package metadata
:link: package-metadata
:link-type: doc

Refresh, skip, inspect, and cache package-name and package-version data.
:::

::::