France Nuage

The French cloud platform for modern applications and services.

Learn more • Website • Issues • Roadmap

Status & Metrics

---

Welcome to France nuage! Sign up to france-nuage.fr and start deploying your applications in our French cloud platform!

You should check our documentation website to know what France nuage is and what is our vision: https://france-nuage.fr/solutions/perspectives

🐓 About France nuage

France nuage is a comprehensive cloud platform designed for modern applications with French sovereignty in mind.

• Fully open-source
• One click deploy unified ecosytem
• RESTful API
• Complete platform control via our intuitive control panel
• Application orchestration with built-in scaling and deployment options
• Automated CI/CD pipelines
• Region-specific deployments with data residency guarantees
• On-Prem or Cloud. Run locally, install on-premises, or use our self-service Cloud service (free tier available)
• Modern dashboard. Our dashboard app is intuitive for both technical and non-technical users
• Sustainable project since inception. Fork it, extend it, and help us build the best French cloud platform

Learn more about France nuage

🚀 France nuage Cloud

France nuage Cloud allows you to create free cloud projects in minutes.

• Free Autonomous Tier: Available with no credit card required
• No Product Limitations: Unlimited users and applications in our platform
• Self-Service Dashboard: Create and monitor all your projects in one place
• End-to-End Solution: Full stack platform with database, auto-scaling, and storage
• Usage-Based Pricing: Pay-as-you-go for our Standard Cloud offering
• Quick Provisioning: Select your desired region in France and provision new resources in minutes

Create your Project • Contact a human

🤔 Community Help

The France nuage Documentation is a great place to start, or explore these other channels:

• Gitlab Issues (Report Bugs, Questions, Feature Requests)
• GitHub Mirror
• Linkedin (Latest News)
• Website (Infos)
• Platform (Login, sign up)

📌 Requirements

France Nuage is built on modern technologies and supports most operating systems.

• Proxmox: Open source type 2 hypervisor based on Debian and KVM
• Supported Databases: PostgreSQL 15+
• Supported OS: Ubuntu LTS, CentOS / RHEL 8, macOS Catalina or newer, Windows 10/11, Docker (DockerHub + Dockerfile)
• Other operating systems may also work, in the future

🚧 Development Setup

Prerequisites

Ensure you have the following installed:

• Docker
• Docker Compose
• GitLeaks

Running France nuage with Docker

To start the project using Docker, run:

docker compose up -d

Stopping the services

To stop the services, run:

docker compose down

Seeding the database

Note: you need to supply valid proxmox data through environment variables. You can setup a local virtualized proxmox instance or provision one on an external cloud provider. Active France Nuage contributors can request access to one of France Nuage development proxmox hypervisors.

The variables defaults to pvedev-dc03 but its authorization token is not provided for security reasons.

docker compose exec postgres sh -c "
psql -U postgres -d postgres \
  -v url=\"'\$PROXMOX_DEV_URL'\" \
  -v token=\"'\$PROXMOX_DEV_AUTHORIZATION_TOKEN'\" \
  -v storage=\"'\$PROXMOX_DEV_STORAGE_NAME'\" \
  -f /home/seed.sql
"

SSL Certificates

For HTTPS communication between services, this project uses a self-signed certificate authority (CA) and server certificates. The certificate generation is handled by the included script.

Automatic Certificate Generation:

./generate-certs.sh

Manual Certificate Trust (if needed):

• macOS: sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain certs/ca.pem
• Linux: Copy certs/ca.pem to /usr/local/share/ca-certificates/ and run sudo update-ca-certificates
• Windows: Use certutil -addstore -f "ROOT" certs/ca.pem (as Administrator)

Certificate Details:

• Validity: 1 year for server certificates, 10 years for CA
• Domains: Supports *.localhost, host.docker.internal, and service names
• Location: Certificates are stored in certs/ directory
• Traefik: Configured via traefik/dynamic.yml for automatic HTTPS

📁 Architecture

For developers working on the platform:

• protocol/ - Protocol Buffer definitions and Google Cloud API compliance validation

Related

France nuage Cloud Status Page

❤️ Contributing & Sponsoring

All security vulnerabilities should be reported in accordance with our Security Policy.

License

France nuage is a premium open-source Server Side Public License (SSPL) v1 project made possible with support from our passionate core team, talented contributors, and amazing Sponsors. Thank you all!

The license allows the free right to use, modify, create derivative works, and redistribute, with two simple limitations:

• You may not provide the products to others as a managed service
• You may not circumvent the license key functionality or remove/obfuscate features protection

© France Nuage 2025