prvng_platform/docs/deployment/known-issues.md

Known Issues - Provisioning Platform

Control-Center Requires Rust Nightly (Edition 2024 Dependency)

Status: Resolved (using nightly) Severity: Low Affects: Docker deployment only Date Reported: 2025-10-07 Date Resolved: 2025-10-07

Issue

Control-center Docker builds fail with the following error:

feature 'edition2024' is required
this Cargo does not support nightly features, but if you
switch to nightly channel you can add
`cargo-features = ["edition2024"]` to enable this feature
```plaintext

### Root Cause

Dependency chain:

```plaintext
control-center → surrealdb 2.3.10 → surrealdb-core 2.3.10 → async-graphql 7.0.17
```plaintext

The `async-graphql-value` crate v7.0.17 requires Rust edition 2024, which is not yet stable in Rust 1.82. Edition 2024 is currently only available in Rust nightly builds.

### Resolution

**Updated Dockerfiles to use Rust nightly** (2025-10-07):

Both `orchestrator/Dockerfile` and `control-center/Dockerfile` now use:

```dockerfile
FROM rustlang/rust:nightly-bookworm AS builder
```plaintext

This provides edition2024 support required by the surrealdb dependency chain.

### Production Considerations

**Rust Nightly Stability**:

- Nightly builds are generally stable for compilation
- The compiled binaries are production-ready
- Runtime behavior is not affected by nightly vs stable compilation
- Consider pinning to a specific nightly date for reproducible builds

**Alternative**: Use native deployment with stable Rust if nightly is a concern:

```bash
cd provisioning/platform/scripts
nu run-native.nu build
nu run-native.nu start-all --background
```plaintext

### Timeline

- **Rust 1.85** (estimated Feb 2025): Expected to stabilize edition 2024
- **SurrealDB 3.x**: May drop async-graphql dependency

### Tracking

- Rust Edition 2024 RFC: <https://github.com/rust-lang/rfcs/pull/3501>
- SurrealDB Issue: <https://github.com/surrealdb/surrealdb/issues>
- async-graphql Issue: <https://github.com/async-graphql/async-graphql/issues>

### Related Files

- `provisioning/platform/control-center/Dockerfile`
- `provisioning/platform/Cargo.toml` (workspace dependencies)
- `provisioning/platform/control-center/Cargo.toml`

---

## RocksDB Build Takes Long Time

**Status**: Known Limitation
**Severity**: Low
**Affects**: All builds

### Issue

RocksDB compilation takes 30-60 seconds during builds.

### Workaround

Use cached Docker layers or native builds with incremental compilation.

---

**Last Updated**: 2025-10-07