# Local Test Environment Deploy 🧪

**URL:** <https://hub.infinito.nexus/t/local-test-environment-deploy/435>\
**Category:** Development\
**Created:** [February 28, 2026, 1:41pm UTC](https://hub.infinito.nexus/t/local-test-environment-deploy/435 "2026-02-28T13:41:56Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![kevinveenbirkenbach](https://hub.infinito.nexus/user_avatar/hub.infinito.nexus/kevinveenbirkenbach/32/7_2.png) [@kevinveenbirkenbach](https://hub.infinito.nexus/u/kevinveenbirkenbach)\
**Post date:** [February 28, 2026, 1:41pm UTC](https://hub.infinito.nexus/t/local-test-environment-deploy/435/1 "2026-02-28T13:41:56Z")

</div>

This article explains the local deployment test helpers used to develop and test **Infinito.Nexus** with the development Docker Compose stack.

All scripts are located here:

👉 [https://github.com/kevinveenbirkenbach/infinito-nexus/tree/master/scripts/tests/deploy/local](https://github.com/kevinveenbirkenbach/infinito-nexus/tree/master/scripts/tests/deploy/local)

They allow you to:

- Deploy a single app
- Deploy all apps
- Quickly iterate on one app
- Reset your local test environment
- Clean up container state

These scripts are primarily intended for **Infinito.Nexus developers**.

* * *

## ⚠ Safety Notice

Some scripts delete data inside the running container, including:

- Inventories
- App entities
- Web configuration
- `/var/lib/infinito`

Always make sure you understand what a script does before running reset or cleanup commands.

* * *

# Requirements 🧩

The local development environment is primarily tested on:

**Manjaro Linux.**

It may also work on:

- Debian
- Ubuntu
- Fedora
- Other Linux distributions
- macOS / Windows (usually via VM)

However, non-Manjaro systems are **not officially optimized or regularly tested**.  
For the most predictable experience, using Manjaro (or a Linux VM) is recommended.

### Required Tools

- Docker
- Docker Compose
- `jq`
- `make`

Before using the test scripts:

```bash
make bootstrap
make dev-environment-bootstrap

```

Run all commands from the repository root.

* * *

# Test Comparison Table 🧾

The main difference between these commands is which inventory file they use and whether they recreate or reuse it.

| Command | Scope | Uses inventory file | Creates inventory | Deploys | Destructive? |
| --- | --- | --- | --- | --- | --- |
| `make test-local-full` | all apps | `${INVENTORY_DIR}/${TEST_DEPLOY_TYPE}.yml` | ✅ | ✅ | ❌ |
| `make test-local-reset` | all apps | `${INVENTORY_DIR}/${TEST_DEPLOY_TYPE}.yml` | ✅ | ❌ | ✅ (wipes inventory) |
| `make test-local-rapid` | 1 app | `${INVENTORY_DIR}/${TEST_DEPLOY_TYPE}.yml` | ❌ | ✅ | ❌ |
| `make test-local-rapid-fresh` | 1 app | `${INVENTORY_DIR}/${TEST_DEPLOY_TYPE}.yml` | ❌ | ✅ | ⚠ (purges entity first) |
| `make test-local-app APP=web-app-nextcloud` | 1 app | `${INVENTORY_DIR}/servers.yml` | ✅ | ✅ | ❌ |
| `make test-local-dedicated` | 1 app | `${INVENTORY_DIR}/servers.yml` | ✅ | ✅ | ⚠ (purges shared entity) |
| `make test-local-run-all` | all apps | `${INVENTORY_DIR}/servers.yml` | ❌ | ✅ | ❌ |
| `make test-local-cleanup` | n/a | n/a | n/a | n/a | ✅ (deletes state) |

* * *

# Quick Start 🚀

## Deploy a Single App (Recommended)

```bash
make test-local-app APP=web-app-nextcloud

```

This will:

- Start the dev stack (if needed)
- Create an inventory
- Deploy the selected app

* * *

## Fast Iteration on One App

If you already have an inventory and just want to redeploy one app quickly:

```bash
make test-local-rapid APP=web-app-nextcloud

```

Use `test-local-rapid-fresh` if you want to purge the app first.

* * *

## Deploy All Apps

For a full local test:

```bash
make test-local-full

```

This discovers all apps, creates the inventory, and deploys everything.

* * *

## Reset Environment

If things are broken or you want a clean start:

```bash
make test-local-reset

```

This recreates the inventory but does not deploy.

* * *

## Cleanup

To remove local container state completely:

```bash
make test-local-cleanup

```

⚠ This is destructive.

* * *

# 🔐 Trust the Local CA (Important)

After a successful local deployment, you must trust the Certificate Authority generated by the Infinito container.

Otherwise, your browser will not allow access to apps under:

```auto
https://<app>.infinito.example

```

Run:

```bash
make trust-ca

```

Then restart your browser.

Only after trusting the local CA will the `*.infinito.example` domains work correctly over HTTPS.

* * *

# When to Use What

| Situation | Recommended Command |
| --- | --- |
| First local deploy | `make test-local-app` |
| Quick app iteration | `make test-local-rapid` |
| Full integration test | `make test-local-full` |
| Reset inventory | `make test-local-reset` |
| Clean everything | `make test-local-cleanup` |

* * *

## Summary

The local deploy test scripts are the main developer tooling for validating:

- Roles
- App integrations
- Deployment logic
- Docker setup
- Cross-app dependencies

Use them for fast feedback during development and for full-stack verification before merging changes.

---

_[View the full topic](https://hub.infinito.nexus/t/local-test-environment-deploy/435)._