# Tenantos Dedicated

## Introduction

Tenantos is a modern solutions for dedicated server and vps management. hostware currently implements the dedicated server part of tenantos which is super useful to automate the entire dedicated server management, starting from automatic PXE installations ending at starting and stopping the dedicated via IPMI.

## Installation

### Category Configuration

Normally to use the tenantos module you just want to create the physical dedicated servers in tenantos and let hostware manage the rest. To do so, you need to set up a [dynamic category](broken://pages/DkcrUpamc8n5UlHp2jr6#dynamic-sources) in hostware which will automatically sync all dedicated servers as products to hostware.

{% hint style="info" %}
Please note that only servers with the tenantos tag "hostware" will be imported. Additionally, every operating system which should be available to hostware also needs a "hostware" tag assigned in tenantos.
{% endhint %}

### IPAM integration

The tenantos module uses the hostware IPAM for ip address assignment. This means that you **dont have to setup your subnets in tenantos** because the module will handle that for you once a dedicated server will be provisioned with that ip address.

This implementation offers all the flexibility of the [hostware IPAM](https://hostware.io/features/hosting/ip-address-management) and maximum convenience as you dont need to login into tenantos for more than the initial server creation. Everything is automated and available in one panel.

#### Setup

To setup the ipam, you need to configure the IPAM settings in the category. This means assigning the pool and defining the min and max number of ip addresses which should be assigned.

hostware wont create all subnets in your hostware IPAM in tenantos at once. Instead, it only creates the subnet **if it is needed by a product order and does not already exist in tenantos**.

<figure><img src="/files/s4uem5k5Yqok65mGIOnO" alt=""><figcaption></figcaption></figure>

#### Dummy subnet

Tenantos needs an IP address to be assigned all the time. Because we have integrated the hostware IPAM, we cant do that because hostware might assign the ip to another server as soon as the previous server got terminated.

We fix this issue by creating a dummy subnet, e.g. "7.8.9.1/24" which will assign a non-existing IP address to servers which dont have an owner/customer assigned.&#x20;

This procedure will save unused IP addresses which can be reused by other servers or other hostings.&#x20;

### Price configuration

When syncing all your dedicated servers in your store, hostware needs to know both the base and the setup price. To do this, you need to write both numbers inside the dedicated server's description in tenantos using the format:

```
price: 55.95
setup: 20
```

hostware will check each line if it starts with "price:" or "setup:" (note the : at the end!)\
This allows you to use the description to also write other messages.

<figure><img src="/files/EyXV0YAYTdV5lJiwJ0Tz" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hostware.io/modules/hosting-provisioning/tenantos-dedicated.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.