> For the complete documentation index, see [llms.txt](https://docs.urbit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.urbit.org/user-manual/os/stars-and-galaxies.md).

# Star and Galaxy Operations

Guide for operating stars and galaxies including hosting, planet distribution, and etiquette.

To boot your galaxy or star, follow our [installation instructions](/get-on-urbit.md).

### Hosting your star <a href="#hosting-your-star" id="hosting-your-star"></a>

If you plan to distribute planets in any capacity, we ask that you keep your star running. If you fail to do so, those planets will become orphans that are unable to communicate with the network unless they transfer to a new star.

See our [cloud hosting instructions](/user-manual/running/cloud-hosting.md) for instructions on settings up a Digital Ocean droplet.

### Distributing planets <a href="#distributing-planets" id="distributing-planets"></a>

You can distribute planets from your star via [Bridge](https://bridge.urbit.org/). As a reminder if you do distribute planets, please boot and run your star on the Arvo network, otherwise those planets won't be able to connect, which has a negative effect on the network as a whole, as orphan planets are left with very limited functionality.

### Software updates <a href="#software-updates" id="software-updates"></a>

By default, your star accepts software updates from its galaxy and routes them to its planets. You can use this mechanism to push custom software to your planets. Keep in mind that planets expect functional, non-breaking software updates, and generally want to be able to communicate with planets that are sponsored by other stars.

### Star-owner etiquette <a href="#star-owner-etiquette" id="star-owner-etiquette"></a>

* If you distribute planets, boot and run your star on the Arvo network, or the planets won't be able to boot for the first time or connect unless they transfer to a different star.
* A star is networking infrastructure. For that reason, the machine running your star or galaxy must have sufficient bandwidth, storage, and processing power for your dependent planets.
* When messaging others, communicate using your star only when speaking in an official/infrastructural capacity. Otherwise, use your personal planet.

### Taxes <a href="#taxes" id="taxes"></a>

Urbit address space has value, which means the distribution of address space has tax implications. You should speak with your tax advisor about these implications.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.urbit.org/user-manual/os/stars-and-galaxies.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
