# Community Hub Guide

This is the community and user documentation for 2i2c's shared, open, community cloud infrastructure service.
It is the **source of truth for expected behavior and value for 2i2c's service**. If something is documented here, then users and 2i2c team members should plan around it.

:::{admonition} New to 2i2c?
:class: tip
See 2i2c's [membership](https://2i2c.org/membership) and [platform](https://2i2c.org/platform) descriptions for an overview.
:::

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

:::{grid-item-card} 👤 I use a hub
:link: user/get-started
:link-type: doc

Researchers, students, post-docs, data analysts

**Common needs:** Access your hub • Work with data • Install packages • Share files

{bdg-primary-line}`User guide →`
:::

:::{grid-item-card} 👨‍💻 I manage a hub
:link: admin/get-started
:link-type: doc

Hub administrators, technical staff, IT support

**Common needs:** Add users • Customize environment • Monitor usage • Configure settings

{bdg-primary-line}`Admin guide →`
:::

:::{grid-item-card} 👥 I lead a community
:link: community-lead/get-started
:link-type: doc

Community leads, PIs, deciders, administrators

**Common needs:** Understand costs • Choose cloud providers • Set policies • Plan service

{bdg-primary-line}`Leadership guide →`
:::

::::

---

## Quick Access

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

:::{grid-item-card}
:link: admin/user-management/authentication-and-access
:link-type: doc

🔐 **Add a user**

Grant access to your hub
:::

:::{grid-item-card}
:link: user/get-started
:link-type: doc

📦 **Install packages**

Add Python/R libraries
:::

:::{grid-item-card}
:link: admin/monitoring/cost-general
:link-type: doc

💰 **View costs**

Monitor cloud spending
:::

:::{grid-item-card}
:link: admin/environment/customize
:link-type: doc

🛠️ **Customize environment**

Configure hub software
:::

:::{grid-item-card}
:link: user/data/object-storage/index
:link-type: doc

☁️ **Access cloud data**

Work with object storage
:::

:::{grid-item-card}
:link: support
:link-type: doc

💬 **Get support**

Contact 2i2c team
:::

::::

---

## Full Documentation

```{toctree}
:maxdepth: 2
:hidden:

user/index
admin/index
community-lead/index
contribute/index
support
```

---

::::{grid} 1
:gutter: 0

:::{grid-item-card} 🆘 Need Help?
:text-align: center

[Contact 2i2c Support](support.md) • [Check Status Page](admin/reliability/status-page.md)
:::

::::

---

## Contributing

Want to improve these docs? See the [Contributing Guide](contribute/index.md).
